Submit API Chat Turn
Submit your agent’s message on an API chat run. The reply is generated in the background — poll the returned turn for it.
Authorizations
API Key Authentication. It should be included in the header of each request.
Path Parameters
A unique integer value identifying this run.
Body
Request body for POST /runs/{run_id}/chat/ (submit one turn). Same message shape
as the websocket chat integration: a normal message (content), optional metadata
merged into the run, and/or a function call (role + data).
Your agent-under-test's latest message. Submitting it returns a turn_id; poll GET /runs/{run_id}/chat/{turn_id}/ for the simulated user's reply.
Optional metadata merged into the run (last-write-wins). Can be sent alone.
Set to record a tool call instead of a message (no reply is generated).
Function Call- Function CallFunction Call Result- Function Call Result
Function Call, Function Call Result Function-call payload: {id, name, arguments} for a call, {id, result} for a result.