Sign in

v2

latestOpenAPI 3.0.02026-07-31172752.6 KB
access_requests

Create multiple access requests

Request access to multiple application resources. When authenticating with an API token, user_id is required to specify the grantee.

post/api/v1/access_requests/bulk

Headers

Idempotency-Keystring

Optional key (1–255 chars) for safely retrying a request. Reusing the same key for the same request returns 409 Conflict and is not processed again — this confirms the request was already received. Keys are retained for 14 days.

Request body

request_reasonstring required

Shared reason for all access requests

user_idstring uuid

User to request access for. Required when authenticating with an API token. With a user login, defaults to the authenticated user if omitted.

Example request

{
  "request_reason": "Need access to complete Q4 reporting",
  "requests": [
    {
      "permission_ids": [
        "7488a646-e31f-11e4-aace-600308960664"
      ],
      "resource_id": "7488a646-e31f-11e4-aace-600308960663"
    },
    {
      "permission_ids": [
        "7488a646-e31f-11e4-aace-600308960666"
      ],
      "resource_id": "7488a646-e31f-11e4-aace-600308960665"
    }
  ]
}

Response

Access requests created

Example response

{
  "data": [
    {
      "application_id": "7488a646-e31f-11e4-aace-600308960662",
      "duration": "PT1H",
      "expires_at": "2023-01-16T10:30:00Z",
      "grantee_user_id": "9488a646-e31f-11e4-aace-600308960666",
      "id": "8488a646-e31f-11e4-aace-600308960665",
      "inserted_at": "2023-01-15T10:30:00Z",
      "permission_ids": [
        "7488a646-e31f-11e4-aace-600308960664"
      ],
      "provisioning_type": "automatic",
      "request_reason": "Need access to complete Q4 reporting",
      "requestor_user_id": "9488a646-e31f-11e4-aace-600308960666",
      "resource_id": "7488a646-e31f-11e4-aace-600308960663",
      "status": "pending_approval"
    }
  ]
}