v2
chat
chat
Create Session
Create (or get-or-create) a chat session.
Two modes, selected by the request body:
- Default: create a fresh session for the user. dry_run=True forces run_block and run_agent calls to use dry-run simulation.
- Builder-bound: when builder_graph_id is set, get-or-create keyed on (user_id, builder_graph_id). Returns the existing session for that graph or creates one locked to it. Graph ownership is validated inside :func:get_or_create_builder_session; raises 404 on unauthorized access. Write-side scope is enforced per-tool (edit_agent / run_agent reject any agent_id other than the bound graph) and a small blacklist hides tools that conflict with the panel's scope (see :data:BUILDER_BLOCKED_TOOLS).
Args: user_id: The authenticated user ID parsed from the JWT (required). request: Optional request body with dry_run and/or builder_graph_id.
Returns: CreateSessionResponse: Details of the resulting session.
post/api/chat/sessions
Request body
Response
Successful Response