v1

latestOpenAPI 3.1.02026-08-04147764567.0 KB

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