Create a connect session
Creates a single-use hosted link for a connection’s owner to consent or enter a key. It expires after 15 minutes.
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"
Optional caller-supplied idempotency key. Any non-empty key up to 64 characters is accepted. Endpoint-specific documentation describes how the key is used.
1 - 64"create-prod-2026-05-07"
Body
Response
Connect session created
A connect session id
^cses_[^\s/]{1,64}$"cses_j572abc123def456"
A vault id
^vlt_[^\s/]{1,64}$"vlt_j572abc123def456"
A connection id
^conn_[^\s/]{1,64}$"conn_j572abc123def456"
PENDING, CONSUMED, EXPIRED Unix timestamp (seconds)
x >= 0Unix timestamp (seconds)
x >= 0The hosted page where the owner signs in to the provider or enters a key. Single use; expires after 15 minutes. It carries no credential and is shown only in this response.