Skip to main content
POST
Submit a turn to an API-chat run

Authorizations

X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Path Parameters

id
integer
required

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).

content
string

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.

metadata
object

Optional metadata merged into the run (last-write-wins). Can be sent alone.

role
enum<string>

Set to record a tool call instead of a message (no reply is generated).

  • Function Call - Function Call
  • Function Call Result - Function Call Result
Available options:
Function Call,
Function Call Result
data
object

Function-call payload: {id, name, arguments} for a call, {id, result} for a result.

Response

Response for POST /runs/{run_id}/chat/ (turn accepted).

run_id
integer
required
result_id
integer
required
turn_id
integer
required

Poll this turn for the simulated user's reply.

status
string
required

Turn status; poll for the reply if 'generating'.