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

# Create Session

`POST /sessions`

## Request body

- CreateSessionRequest — Payload for creating a session
  - `user` string, uuid, nullable
  - `users` string[], nullable
  - `agent` string, uuid, nullable
  - `agents` string[], nullable
  - `situation` string, nullable
  - `system_template` string
  - `render_templates` boolean
  - `token_budget` integer, nullable
  - `context_overflow` 'truncate' | 'adaptive', nullable
  - `auto_run_tools` boolean
  - `forward_tool_calls` boolean
  - `recall_options` RecallOptions
    - `mode` 'hybrid' | 'vector' | 'text'
    - `num_search_messages` integer
    - `max_query_length` integer
    - `alpha` number
    - `confidence` number
    - `limit` integer
    - `lang` 'en-US'
    - `metadata_filter` object
    - `mmr_strength` number
  - `metadata` object, nullable

## Response `201`

Successful Response

- ResourceCreatedResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `jobs` string[]

## Other responses

- `422` — Validation Error

## Changes

- **2025-01-16** `ea124be3fdbc` — 1 info
  - the `recall_options/anyOf[subschema #1: RecallOptions]/confidence` request property's min was decreased from `0.00` to `-1.00`
- **2025-01-16** `a707ace7212c` — 1 breaking
  - the `recall_options/anyOf[subschema #1: RecallOptions]/confidence` request property's min was increased to `0.00`
- **2025-01-16** `ea124be3fdbc` — 1 info
  - the `recall_options/anyOf[subschema #1: RecallOptions]/confidence` request property's min was decreased from `0.00` to `-1.00`

[Change history](https://skmtc.dev/julep-ai/apis/julep-agents-api/changes/sessions/post.md)

---

[API](https://skmtc.dev/julep-ai/apis/julep-agents-api.md) · [All operations](https://skmtc.dev/julep-ai/apis/julep-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/julep-ai/julep-agents-api/revisions/ea124be3fdbc/schema)