Revoke a connection
Stops all use of the connection immediately and answers with state REVOKING. The provider is then asked to revoke and the stored credential is erased in the background, however long that takes, and the state becomes REVOKED. Grants on the connection stop applying at once.
Authorizations
workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens
Headers
Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens - a workspace-owned token implies its workspace.
1 - 53"ws_j572abc123def456"
Path Parameters
A connection id
^conn_[^\s/]{1,64}$"conn_j572abc123def456"
Response
Connection
A connection id
^conn_[^\s/]{1,64}$"conn_j572abc123def456"
A vault id
^vlt_[^\s/]{1,64}$"vlt_j572abc123def456"
A connector's stable slug.
^[a-z0-9][a-z0-9_-]{0,63}$"openai"
1 - 100Who owns the connection: the Workspace (a shared account), one user (their own account) or an end customer user in a reseller vault.
- Option 1
- Option 2
- Option 3
PENDING_CONSENT, CONNECTED, REAUTH_REQUIRED, REVOKING, REVOKED, ERROR Unix timestamp (seconds)
x >= 0