---
title: "Create Session"
method: POST
path: "/api/v1/chat"
tags: ["Chat"]
---

# Create Session

`POST /api/v1/chat`

Create a chat session, optionally bound to indexes (locked after the first message).

## Query parameters

- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Request body

- SessionCreate — Request body for creating a chat session.
  - `index_ids` string[], nullable — Indexes this session will retrieve from. Once set and the first message has been sent, the source set is locked for the session's lifetime. Leave null to create an unbound session.

## Response `201`

Successful Response

- ChatSessionSummary — Summary of a chat session, including its title and last run metadata.
  - `session_id` string, required — Unique session identifier.
  - `generated_title` string, nullable — Auto-generated title derived from the first user message.
  - `last_updated_at` string, required — ISO-format timestamp showing when the session was last updated.
  - `job_metadata` JobMetadata
    - `total_input_tokens` integer, nullable
    - `total_output_tokens` integer, nullable
    - `turns` integer
    - `duration_ms` number
    - `is_error` boolean
    - `error` string, nullable
    - `export_config_ids` string[], nullable
  - `index_ids` string[], nullable — Indexes this session is bound to. Null on unbound sessions.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.net/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/run-llama/llama-platform/revisions/b17341164de9/schema)