Mail API reference

Mail API · Integrations

delete/v1/workspaces/{workspace_id}/integrations/{provider}Auth

Disconnect an integration. Deletes the credential row.

Hard delete — the encrypted blob is removed. The customer must reconnect via the provider-specific OAuth flow to restore access.

Path parameters

workspace_id*string · uuid

Id of the workspace.

provider*string

The integration provider (`github`).

Headers

Idempotency-Keystring

Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. A retry with the same key and body returns the original response with `Idempotent-Replay: true`.

Response · 204

Disconnected.

Example

Request

DELETE https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/integrations/{provider}
Authorization: Bearer YOUR_TOKEN