Skip to main content
POST
Open an agent conversation

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
Required string length: 1 - 54
idempotency-key
string
required

Required stable key. Retry the identical key and input after an uncertain response.

Required string length: 1 - 64

Body

application/json
agent_id
string
required
Pattern: ^(?:agt_)?[a-zA-Z0-9]{1,50}$
agent
any
title
string
Required string length: 1 - 200

Response

AgentSessionOpenAcknowledgement

status
enum<string>
required
Available options:
created
session_id
string
required
Pattern: ^(?:ags_)?[a-zA-Z0-9]{1,50}$
agent_id
string
required
Pattern: ^(?:agt_)?[a-zA-Z0-9]{1,50}$