v3
latestOpenAPI 3.1.02026-07-311,4541,5202.3 MBagents
Sessions Turns 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/sessions/{session_id}/turns/
Path parameters
session_idstring required
Headers
Authorizationstring required
JWT access token or Respan API key
Request body
Response
No response body
AgentsSessionsTurnsCreateResponse200 required
Empty response body