Skip to main content
POST
Revoke a connection

Authorizations

Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

akua-context
string

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.

Required string length: 1 - 53
Example:

"ws_j572abc123def456"

Path Parameters

id
string
required

A connection id

Pattern: ^conn_[^\s/]{1,64}$
Example:

"conn_j572abc123def456"

Response

Connection

id
string
required

A connection id

Pattern: ^conn_[^\s/]{1,64}$
Example:

"conn_j572abc123def456"

vault_id
string
required

A vault id

Pattern: ^vlt_[^\s/]{1,64}$
Example:

"vlt_j572abc123def456"

connector
string
required

A connector's stable slug.

Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$
Example:

"openai"

name
string
required
Required string length: 1 - 100
owner
object
required

Who owns the connection: the Workspace (a shared account), one user (their own account) or an end customer user in a reseller vault.

state
enum<string>
required
Available options:
PENDING_CONSENT,
CONNECTED,
REAUTH_REQUIRED,
REVOKING,
REVOKED,
ERROR
created_at
integer
required

Unix timestamp (seconds)

Required range: x >= 0