---
title: "Create session"
method: POST
path: "/session"
tags: ["session"]
---

# Create session

`POST /session`

Create a new session. Optionally associate with a user identifier. You can also specify a custom UUID using use_uuid.

## Request body

- HandlerCreateSessionReq
  - `configs` object
  - `disable_task_tracking` boolean
  - `use_uuid` string
  - `user` string

## Response `201`

Created

- object
  - `code` integer
  - `error` string
  - `msg` string
  - `data` ModelSession
    - `configs` object
    - `created_at` string
    - `disable_task_tracking` boolean
    - `id` string
    - `project_id` string
    - `updated_at` string
    - `user_id` string

## Other responses

- `400` — Invalid UUID format
- `409` — Session with this UUID already exists

## Changes

> 50 revisions in range; 1 could not be searched.

- **2026-02-02** `91c9047c4b2a` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
- **2025-11-12** `a1c1bcb0e2ee` — 2 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`

[Change history](https://skmtc.dev/memodb-io/apis/acontext-api/changes/session/post.md)

---

[API](https://skmtc.dev/memodb-io/apis/acontext-api.md) · [All operations](https://skmtc.dev/memodb-io/apis/acontext-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/memodb-io/acontext-api/revisions/c8775333b1ed/schema)