---
title: "V 2 Sessions Create"
method: POST
path: "/agents/v2/sessions/"
tags: ["agents"]
---

# V 2 Sessions Create

`POST /agents/v2/sessions/`

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)

## Headers

- `Authorization` string, required

## Request body

- TurnRequestRequest
  - `input` object[], required
  - `timezone` string
  - `conversation` string, nullable
  - `parent_message_id` string, nullable
  - `model` string, nullable
  - `page_context` object, nullable
  - `skill_ids` string[]
  - `is_read_only` boolean

## Response `200`

No response body

- AgentsV2SessionsCreateResponse200 — Empty response body

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)