Skip to main content
POST
Append a message to a thread

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Identifies one submission attempt. Retrying with the same key returns the original admission with Idempotent-Replayed: true. Use a new key after changing any request field.

Path Parameters

threadId
string
required

Body

application/json
content
object[]
required

Ordered message content, bounded to 512 KiB of encoded JSON. At most 20 image blocks are permitted and image IDs must be unique within the message.

Required array length: 1 - 40 elements
mode
enum<string>
Available options:
queue,
steer,
interrupt
model
string

Optional concrete catalog model id selected from the target agent profile for queue or interrupt submissions; wildcard selectors are not accepted, and model is not accepted with steer.

Pattern: ^[^*]+$

Response

Accepted message submission.

status
enum<string>
required
Available options:
running,
awaiting,
idle,
failed,
cancelled
threadId
string
required
turnId
string
required