ACaccessowl
access_revocations

Mark an access revocation as revoked

Changed on

Marks a (pending) access revocation as revoked, recording the caller as the provisioner. When there is no current access left to revoke, the revocation is closed as rejected instead — the returned status reflects the outcome.

post/api/v1/access_revocations/{access_revocation_id}/revoke

Request

  • Base URL
    https://app.accessowl.io
  • URL
    https://app.accessowl.io/api/v1/access_revocations/{access_revocation_id}/revoke
  • Auth
    HTTP bearer

Path parameters

access_revocation_idstring uuid required

Access revocation ID

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.

Response

Access revocation revoked

application_idstring uuid required

Application ID

grantee_user_idstring uuid

User ID of the grantee

idstring uuid required

Access revocation ID

inserted_atstring date-time

Creation timestamp

permission_idsstring[] nullable

Permission IDs being revoked

provisioning_type'application_admin' | 'automatic' nullable

Provisioning type

reasonstring required

Revocation reason

requestor_user_idstring uuid

User ID of the requestor

resource_idstring uuid nullable

Resource ID (null for app-wide revocations)

status'processing_access' | 'rejected' | 'revoked' required

Current status of the revocation

termination_reasonstring nullable

The provisioner's rejection reason when the revocation was rejected; null otherwise

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 optional property to the response with the status

  • 209e132db90bRevision changes
    • info

      endpoint added