Skip to main content
POST
Send a message

Authorizations

Authorization
string
header
required

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path Parameters

orgId
string
required

Organization id or slug. Resolve it with GET /v3/self.

sessionId
string
required

The session id.

Body

application/json
message
string
required
model
string

Optional model id from GET /agent-auth/models to retry this session on. A model override always starts a new continuation run, because a run's model is fixed at its first execution. Omit or use auto to keep the session's current model.

reasoning_effort
enum<string>

Optional reasoning effort override applied to the continuation run.

Available options:
low,
medium,
high,
xhigh

Response

Message accepted and delivered or queued for a continuation.

ok
boolean
required
delivery
string
continuation_session_id
string | null

The new session created to continue a completed run. Clients should switch their event and message polling to this id.