Skip to content
Proud to collaborate with Microsoft for Startups

identity.app.deprovision ​

Deprovision an identity app and invalidate app-owned identity state

Deprovision an identity app and invalidate app-owned identity state.

Inputs:

  • organization_uuid, identity_app_uuid (required)
  • actor, reason (optional)

Outputs:

  • deprovisioned, already_deprovisioned, status, deleted_at
  • counts for clients/providers/end-users/grants/codes/tokens touched

Overview ​

PropertyValue
Workflow typeLinear
LibraryApp-identity
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
actorstringNo——
organization_uuiduuidYes——
identity_app_uuiduuidYes——
reasonstringNo——

Output Schema ​

FieldTypeRequiredDefaultDescription
identity_app_uuiduuidYes——
deprovisionedbooleanYes——
already_deprovisionedbooleanYes——
statusstringNo——
deleted_atstringNo——
clients_deprovisionedintegerNo——
federation_providers_deprovisionedintegerNo——
end_users_deprovisionedintegerNo——
app_grants_deprovisionedintegerNo——
auth_codes_revokedintegerNo——
verification_tokens_revokedintegerNo——
exposed_virtual_workflows_removedintegerNo——
persistedbooleanNo——
actorstringNo——
reasonstringNo——
failure_reasonstringNo——
failure_typestringNo——
failed_actionstringNo——
failed_at_statestringNo——

States ​

StateInitialTerminalSuccessAuto-advanceDescription
initiatedYesNo—validate—
deprovisioningNoNo—complete—
validatingNoNo—deprovision—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
initiatedvalidatevalidating—
validatingdeprovisiondeprovisioning—
deprovisioningcompletecompleted—
* (any state)failfailed—

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "identity.app.deprovision",
  "initial_data": {
    "organization_uuid": "value",
    "identity_app_uuid": "value"
  }
}