---
title: "Patch Session"
method: PATCH
path: "/sessions/{session_id}"
tags: ["sessions"]
---

# Patch Session

`PATCH /sessions/{session_id}`

## Path parameters

- `session_id` string, uuid, required

## Request body

- PatchSessionRequest — Payload for patching a session
  - `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` RecallOptionsUpdate
    - `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 `200`

Successful Response

- ResourceUpdatedResponse
  - `id` string, uuid, required
  - `updated_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: RecallOptionsUpdate]/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: RecallOptionsUpdate]/confidence` request property's min was increased to `0.00`
- **2025-01-16** `ea124be3fdbc` — 1 info
  - the `recall_options/anyOf[subschema #1: RecallOptionsUpdate]/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/:session_id/patch.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)