Skip to main content
POST
Run an agent (streaming or one-shot)

Authorizations

Authorization
string
header
required

WorkOS session token or RunTools API key (rt_live_* / rt_test_*). Used in Authorization: Bearer <token> header.

Body

application/json
agent
string
required

Agent slug or UUID.

prompt
string
stream
boolean
default:true
messages
object[]
threadId
string

Optional thread ID for server-managed conversation persistence.

config
object
metadata
object

Response

Run completed (non-streaming) or registered (local-mac caller).

data
object