Disconnect Custom Integration

Disconnect a custom integration by its Descope app ID.

Authorization is by deterministic-ID prefix: only apps whose ID matches cust-{tenant-prefix}- are accepted, which scopes the operation to the caller’s workspace without a DB lookup. scope selects which side’s tokens to revoke (per-user vs tenant-wide); delete_app=true removes the Descope app entirely (affects every user in the workspace).

Disconnect a custom integration by its Descope app ID. Authorization is by deterministic-ID prefix: only apps whose ID matches ``cust-{tenant-prefix}-`` are accepted, which scopes the operation to the caller's workspace without a DB lookup. ``scope`` selects which side's tokens to revoke (per-user vs tenant-wide); ``delete_app=true`` removes the Descope app entirely (affects every user in the workspace).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

descope_app_idstringRequired

Query parameters

scopeenumOptional

Which token to revoke: ‘user’ (this user’s personal) or ‘tenant’ (workspace)

Allowed values:

delete_appbooleanOptionalDefaults to false

Also remove the Descope outbound app entirely (affects every user in this workspace)

Response

Successful Response

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

1	curl -X DELETE "/integrations/custom/descope_app_id?scope=tenant&delete_app=true" \
2	-H "user-agent: IsloClient/1.2.3 (Linux; x86_64)" \
3	-H "Authorization: Bearer <api_key>" \
4	-H "Content-Type: application/json" \
5	-d '{}'