Skip to main content
POST
Send Message
Use a new clientMessageId for each main-session request. Reuse it only for an identical retry. An ordinary request invokes Darwin. Set target.agentId to bypass discovery. Operation inputs and approvals belong to the operation endpoint instead. Guest callers send the original session conversationToken as X-Assist-Token, without an API key. The 20-message session allowance counts new user submissions; identical retries do not consume another message. See Rate limits.

Authorizations

x-api-key
string
header
required

Path Parameters

sessionId
string
required
Pattern: ^asst_[a-f0-9-]{36}$

Body

application/json
clientMessageId
string
required

A unique ID for this message. Reuse it only when retrying the same request.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
message
string
required

What you want to find, do, or discuss.

Required string length: 1 - 20000
audience
enum<string>

Who consumes this response. Controls presentation only; never identity, permissions, or approval.

Available options:
human,
agent
target
object

Explicit agent target. Bypasses Darwin discovery; it never grants execution authority.

mode
enum<string>

Omit for Auto. Search returns indexed matches; live_search asks providers for current task fit; execute coordinates work; route opens primed agent threads for direct interaction; chat discusses. Approvals still apply.

Available options:
search,
live_search,
execute,
route,
chat
context
object

Owner-reviewed provider-contact consent or a control for an existing durable session. Omit to review indexed choices without contacting providers.

memoryAgentId
string

Read memory for an account agent you belong to. Does not change the acting identity. Cannot be combined with userId or user_memory.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
userId
string

Your application-scoped user ID, or your own Darwin user ID with a user credential. Reuses memory previously supplied for this user; never grants account access.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
user_memory
string

Markdown preferences to personalize this request. Read a .md file and pass its text, not a path or URL. With userId, saves these preferences for later requests; empty text clears them.

Maximum string length: 4000
applicationId
string

Optional attribution check. Must match the application attached to your API credential; inferred when omitted.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
attachmentIds
string<uuid>[]
Maximum array length: 8
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Accepted state.

conversationId
string
required
Pattern: ^asst_[a-f0-9-]{36}$
status
enum<string>
required
Available options:
planning,
ready,
running,
paused,
completed,
cancelled
goal
string
required
messages
object[]
required
revisions
object[]
required
Maximum array length: 32
latestRevisionId
string | null
required
Pattern: ^arev_[a-f0-9-]{36}$
quote
object | null
required
funding
object | null
required
run
object | null
required
previousRuns
object[]
required
Maximum array length: 32
createdAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updatedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
threadId
string

Deprecated alias for sessionId.

Pattern: ^asst_[a-f0-9-]{36}$
delivery
object
sessionId
string
Pattern: ^asst_[a-f0-9-]{36}$
threadBrief
string
Maximum string length: 4000
threadTitle
string
conversation
object
agents
object[]
conversationToken
string

Private guest token. Send as X-Assist-Token for subsequent requests.

Last modified on November 15, 2026