Sign in
accessManagement

Revoke a grant

Revoke a grant. By default (skip_deprovisioning=true), marks the grant as REVOKED immediately without triggering IDP deprovisioning. Set skip_deprovisioning=false to trigger the full deprovisioning workflow (Azure AD/Okta group removal or service request creation).

post/api/v1/iga/grants/{grant_id}/revoke

Path parameters

grant_idinteger required

The grant ID to revoke

Headers

X-Api-Keystring required
X-Workspace-Idstring

Request body

reasonstring

Optional reason for revoking the grant

skip_deprovisioningboolean

When true (default), marks the grant as REVOKED immediately without triggering IDP deprovisioning. When false, triggers the full deprovisioning workflow (Azure AD/Okta group removal or service request creation).

Response

Successful response

AccessManagementPostapiV1IgaGrantsGrantIdRevokeResponse200 required

Empty response body

Changes

Changed in 1 of the 4 revisions of this API.1

  • 2ab1cf36239b1See the full diff
    • ○

      api operation id postapi-v-1-iga-grants-grant-id-revoke removed and replaced with postapi_v1_iga_grants__grant_id__revoke

      api-operation-id-removed