Skip to main content
POST
Create agent run

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string
required

A unique key for this logical mutation (at most 128 bytes). Reuse it only when retrying the same request. Required for POST; optional for other mutations.

Body

application/json
threadId
string
required
Required string length: 1 - 255
runId
string
required
Required string length: 1 - 255
messages
object[]
required
Maximum array length: 1000
tools
any[]
required
context
any[]
required
forwardedProps
object
required
parentRunId
string | null
state
object | null
resume
object[]
Maximum array length: 100

Response

Accepted for processing; completion is not yet confirmed.

data
object
required