ACaccessowl
access_requests

Create multiple access requests

Changed on

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

Request

  • Base URL
    https://app.accessowl.io
  • URL
    https://app.accessowl.io/api/v1/access_requests/bulk
  • Auth
    HTTP bearer

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",
      "approval_steps": [
        {
          "approvers": [
            {
              "decided_at": "2023-01-15T11:00:00Z",
              "decided_by_user_id": "9488a646-e31f-11e4-aace-600308960667",
              "status": "approved",
              "user_id": "9488a646-e31f-11e4-aace-600308960667"
            }
          ],
          "decided_at": "2023-01-15T11:00:00Z",
          "status": "approved",
          "step": 1,
          "strategy": "all"
        },
        {
          "approvers": [
            {
              "decided_at": null,
              "decided_by_user_id": null,
              "status": "pending",
              "user_id": "9488a646-e31f-11e4-aace-600308960668"
            },
            {
              "decided_at": null,
              "decided_by_user_id": null,
              "status": "pending",
              "user_id": "9488a646-e31f-11e4-aace-600308960669"
            }
          ],
          "decided_at": null,
          "status": "pending",
          "step": 2,
          "strategy": "first_to_respond"
        },
        {
          "approvers": [
            {
              "decided_at": null,
              "decided_by_user_id": null,
              "status": "pending",
              "user_id": "9488a646-e31f-11e4-aace-60030896066a"
            }
          ],
          "decided_at": null,
          "status": "pending",
          "step": 3,
          "strategy": "all"
        }
      ],
      "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",
      "termination_reason": null
    }
  ]
}

Changes

  • 5a1f071e40d8Revision changes
    • breaking

      response property errors/additionalProperties/items/ list-of-types was widened by adding types object to media type application/json of response 422

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      added the new forbidden enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

  • 209e132db90bRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status