Skip to main content
POST
Send a follow-up message to a session

Authorizations

X-Api-Key
string
header
required

Workspace API key, created in the dashboard under Settings → API Keys.

Headers

Idempotency-Key
string

Caller-provided key for safe retries. The same key in the same workspace yields the same run id, and a duplicate POST within the retention window returns the original run instead of starting a second one.

Maximum string length: 256

Path Parameters

id
string
required

Session ID.

Body

application/json
prompt
string
required

The follow-up message.

Minimum string length: 1
maxDurationSecs
integer

Optional cap on the follow-up run's duration, in seconds. The server applies its own upper bound.

Required range: x >= 1
workspaceId
string<uuid>

Optional for workspace-scoped API keys.

Response

Follow-up accepted, dispatched or queued

id
string
required

The session id (unchanged).

status
enum<string>
required
Available options:
queued
deviceId
string
required
workspaceId
string<uuid>
required
invocationId
string

The follow-up's invocation. Absent when an Idempotency-Key matched a follow-up that has already run.

queued
boolean

true when the follow-up waits behind the session's current run. Cancel it with DELETE /v1/sessions/{id}/queue/{invocationId}.

queuedEventId
string

Id of the followup_queued event, when queued is true.