Sign in

v5

latestOpenAPI 3.1.02026-07-31151195455.5 KB
requests

Create an access request

post/requests

Request body

target_user_idstring uuid

The ID of the user to be granted access. Should not be specified if target_group_id is specified.

target_group_idstring uuid

The ID of the group the request is for. Should not be specified if target_user_id is specified.

reasonstring required
duration_minutesinteger required

The duration of the request in minutes. -1 represents an indefinite duration

Example request

{
  "resources": [
    {
      "id": "group283-ca87-4a8a-bdbb-df212eca5353",
      "access_level_remote_id": "arn:aws:iam::490306337630:role/SupportUser",
      "access_level_name": "arn:aws:iam::490306337630:role/SupportUser"
    }
  ],
  "groups": [
    {
      "id": "f454d283-ca87-4a8a-bdbb-df212eca5353",
      "access_level_remote_id": "arn:aws:iam::490306337630:role/SupportUser",
      "access_level_name": "arn:aws:iam::490306337630:role/SupportUser"
    }
  ],
  "target_user_id": "userd283-ca87-4a8a-bdbb-df212eca5353",
  "target_group_id": "userd283-ca87-4a8a-bdbb-df212eca5353",
  "support_ticket": {
    "ticketing_provider": "LINEAR"
  }
}

Response

The resulting request.

idstring uuid

Example response

{
  "id": "4baf8423-db0a-4037-a4cf-f79c60cb67a5"
}