Hanzo
OpenapiIntegrations

Revokes (best-effort) and forgets an org's connection: it deletes every…

Revokes (best-effort) and forgets an org's connection: it deletes every custodied KMS secret and the connection row.

POST /v1/integrations/{provider}/disconnect

Addresshttps://api.hanzo.ai/v1/integrations/{provider}/disconnect
MethodPOST
Operationpost_integrations_by_provider_disconnect
AuthAuthorization: Bearer $HANZO_API_KEY

Revokes (best-effort) and forgets an org's connection: it deletes every custodied KMS secret and the connection row. Idempotent — disconnecting a provider that was never connected still returns {disconnected:true}. Symmetric with connect: an AdminOnly connector needs the caller's own-org admin bit.

Request

1 field.

FieldInTypeRequiredDescription
providerpathstringyesProvider is the registry id of the connector — "slack", "github", "cloudflare".

Response

StatusBodyMeaning
200disconnectOutok

200 body — 1 field.

FieldInTypeAlwaysDescription
disconnectedbodybooleanDisconnected is always true — the org's secrets and connection row are gone.

Failure carries the platform error shape — see Errors.

Examples

hanzo integrations disconnect <provider>

Integrations API · All Hanzo APIs · Interactive reference

How is this guide?

On this page