Skip to navigation
API Referenceintegrations

Disconnect Custom Integration

Disconnect a custom integration by its stable provider slug.

The provider is resolved only within the authenticated tenant’s custom service catalog, so callers cannot target another workspace. 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

providerstringRequired

Headers

X-Islo-Api-VersionstringRequired

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
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error