v3

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

V 2 Sessions Create

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)
post/agents/v2/sessions/

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

AgentsV2SessionsCreateResponse200 required

Empty response body