---
title: "Create a managed conversation session"
method: POST
path: "/v1/tools/session-create"
tags: ["AI"]
---

# Create a managed conversation session

`POST /v1/tools/session-create`

## Request

- Base URL: `https://archtools.dev`
- URL: `https://archtools.dev/v1/tools/session-create`
- Auth: API key in header `x-api-key`

## Request body

- object
  - `namespace` string, required: Session namespace or grouping key
  - `system_prompt` string: System prompt for the session
  - `system` string: Legacy alias for system_prompt
  - `model` 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-haiku-4-5-20251001' | 'gpt-4o' | 'gpt-4o-mini': AI model to use

## Response `200`

Session ID and metadata

---

[API](https://skmtc.dev/archtools/apis/arch-tools-api.md) · [All operations](https://skmtc.dev/archtools/apis/arch-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/archtools/apis/arch-tools-api/revisions/ed6c1f974033?raw)