---
title: "POST /requests"
method: POST
path: "/requests"
tags: ["requests"]
---

# POST /requests

`POST /requests`

Create an access request

## Request body

- CreateRequestInfo — All the information needed for creating a request
  - `resources` object[], required
    - `id` string, uuid — The ID of the resource requested. Should not be specified if group_id is specified.
    - `access_level_remote_id` string — The ID of the access level requested on the remote system.
    - `access_level_name` string — The ID of the access level requested on the remote system. This field is deprecated and no longer required. We will populate based on the access_level_remote_id.
  - `groups` object[], required
    - `id` string, uuid, required — The ID of the group requested. Should not be specified if resource_id is specified.
    - `access_level_remote_id` string — The ID of the access level requested on the remote system.
    - `access_level_name` string — The ID of the access level requested on the remote system.
  - `target_user_id` string, uuid — The ID of the user to be granted access. Should not be specified if target_group_id is specified.
  - `target_group_id` string, uuid — The ID of the group the request is for. Should not be specified if target_user_id is specified.
  - `reason` string, required
  - `support_ticket` object
    - `ticketing_provider` 'JIRA' | 'LINEAR' | 'SERVICE_NOW', required — The third party ticketing platform provider.
    - `remote_id` string, required
    - `identifier` string, required
    - `url` string, required
  - `duration_minutes` integer, required — The duration of the request in minutes. -1 represents an indefinite duration
  - `custom_metadata` object[]
    - `name` string, required
    - `type` 'SHORT_TEXT' | 'LONG_TEXT' | 'BOOLEAN' | 'MULTI_CHOICE', required — The type of the custom request field.
    - `value` string, required

## Response `200`

The resulting request.

- object
  - `id` string, uuid

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/versions/13b58df96d40/schema)