V 2 Sessions Turns Create

POST

https://api.respan.ai/agents/v2/sessions/:session_id/turns/

V2 agent chat — single loop with two-tier tool loading.

POST /agents/v2/sessions/ (auto-generates session_id) POST /agents/v2/sessions/<session_id>/turns/ (explicit session_id)

Request body: same as v1 (input, timezone, conversation, parent_message_id, model). Response: Server-Sent Events stream.

Differences from v1:

Single loop instead of multi-agent graph
Two-tier tool loading (~20 core, ~70 deferred via tool_search)

V2 agent chat — single loop with two-tier tool loading. POST /agents/v2/sessions/ (auto-generates session_id) POST /agents/v2/sessions/<session_id>/turns/ (explicit session_id) Request body: same as v1 (input, timezone, conversation, parent_message_id, model). Response: Server-Sent Events stream. Differences from v1: - Single loop instead of multi-agent graph - Two-tier tool loading (~20 core, ~70 deferred via tool_search)

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

$	curl -X POST https://api.respan.ai/agents/v2/sessions/session_id/turns/ \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"input": [
>	{}
>	]
>	}'