API Referenceagents

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.

Authentication

AuthorizationBearer
JWT access token or Respan API key

Path parameters

session_idstringRequired

Request

This endpoint expects an object.
inputlist of maps from strings to anyRequired
timezonestringOptional>=1 characterDefaults to UTC
conversationstring or nullOptional>=1 character
parent_message_idstring or nullOptional>=1 character
modelstring or nullOptional>=1 character
page_contextmap from strings to any or nullOptional
skill_idslist of stringsOptional
is_read_onlybooleanOptionalDefaults to false

Response

No response body