v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
agents

Chat Create

Create a turn within an agent chat session (streams SSE response).

POST /agents/sessions/<session_id>/turns/ POST /agents/chat/

Request body (JSON): input (list, required): Full conversation messages. Last message must have role user. Messages may include file_ids (list[str]) to attach files uploaded via POST /agents/files/. timezone (str, optional): IANA timezone, defaults to UTC. conversation (str, optional): Conversation ID for persistence. parent_message_id (str, optional): Message ID to parent this turn under in the conversation tree.

Response: Server-Sent Events stream.

post/agents/chat/

Headers

Authorizationstring required

JWT access token or Respan API key

Request body

inputobject[] required
timezonestring
conversationstring nullable
parent_message_idstring nullable
modelstring nullable
page_contextobject nullable
skill_idsstring[]
is_read_onlyboolean

Response

No response body

AgentsChatCreateResponse200 required

Empty response body