---
title: "Changes to Patch Session"
method: PATCH
path: "/sessions/{session_id}"
---

# Changes to Patch Session

`PATCH /sessions/{session_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 15 of 44 revisions.

- **2025-06-26** `a5693caa5db1` — 6 info
- **2025-05-12** `088c2ebb8988` — 10 info
- **2025-03-03** `1f91c7da5438` — 1 breaking, 5 info
- **2025-03-01** `5760ee26a52a` — 1 breaking, 1 info
- **2025-02-28** `4d9d1f8b357a` — 1 breaking, 3 info
- **2025-02-27** `bf9190a8aea0` — 1 breaking, 3 info
- **2025-02-26** `e01e4f400de2` — 6 breaking, 3 info
- **2025-02-25** `1a338af95f85` — 3 breaking, 3 info
- **2025-02-25** `2f61540b4f3d` — 4 breaking, 6 warning
- **2025-02-24** `0ddb64e7a598` — 1 breaking, 3 info
- **2025-02-18** `854c2437e2f6` — 1 breaking, 3 info
- **2025-01-27** `f87931a479bd` — 1 warning, 13 info
- **2025-01-16** `ea124be3fdbc` — 1 info
- **2025-01-16** `a707ace7212c` — 1 breaking
- **2025-01-16** `ea124be3fdbc` — 1 info

## Changes

- **2025-06-26** `a5693caa5db1` — 6 info
  - added the new optional request property `recall_options/anyOf[subschema #1: VectorDocSearchUpdate]/include_embeddings`
  - added the new optional request property `recall_options/anyOf[subschema #2: TextOnlyDocSearchUpdate]/include_embeddings`
  - added the new optional request property `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/include_embeddings`
  - added the optional property `recall_options/anyOf[subschema #1: VectorDocSearch]/include_embeddings` to the response with the `200` status
  - added the optional property `recall_options/anyOf[subschema #2: TextOnlyDocSearch]/include_embeddings` to the response with the `200` status
  - added the optional property `recall_options/anyOf[subschema #3: HybridDocSearch]/include_embeddings` to the response with the `200` status
- **2025-05-12** `088c2ebb8988` — 10 info
  - added the new optional request property `recall_options/anyOf[subschema #2: TextOnlyDocSearchUpdate]/trigram_similarity_threshold`
  - added the new optional request property `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/k_multiplier`
  - added the new optional request property `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/trigram_similarity_threshold`
  - the `confidence` request property default value changed from `0` to `0.5`
  - the `confidence` request property default value changed from `0` to `0.5`
  - added the optional property `recall_options/anyOf[subschema #2: TextOnlyDocSearch]/trigram_similarity_threshold` to the response with the `200` status
  - added the optional property `recall_options/anyOf[subschema #3: HybridDocSearch]/k_multiplier` to the response with the `200` status
  - added the optional property `recall_options/anyOf[subschema #3: HybridDocSearch]/trigram_similarity_threshold` to the response with the `200` status
  - the `confidence` response's property default value changed from `0` to `0.5` for the status `200`
  - the `confidence` response's property default value changed from `0` to `0.5` for the status `200`
- **2025-03-03** `1f91c7da5438` — 1 breaking, 5 info
  - the `mode` request property const value `hybrid` was added
  - added `#/components/schemas/VectorDocSearchUpdate, #/components/schemas/TextOnlyDocSearchUpdate` to the `recall_options` request property `anyOf` list
  - the `alpha` request property default value changed from `0.75` to `0.5`
  - added `#/components/schemas/VectorDocSearch, #/components/schemas/TextOnlyDocSearch` to the `recall_options` response property `anyOf` list for the response status `200`
  - the `mode` response property const value `hybrid` was added for the status `200`
  - the `alpha` response's property default value changed from `0.75` to `0.5` for the status `200`
- **2025-03-01** `5760ee26a52a` — 1 breaking, 1 info
  - removed `#/components/schemas/VectorDocSearchUpdate, #/components/schemas/TextOnlyDocSearchUpdate` from the `recall_options` request property `anyOf` list
  - removed `#/components/schemas/VectorDocSearch, #/components/schemas/TextOnlyDocSearch` from the `recall_options` response property `anyOf` list for the response status `200`
- **2025-02-28** `4d9d1f8b357a` — 1 breaking, 3 info
  - removed `#/components/schemas/RecallOptionsUpdate` from the `recall_options` request property `anyOf` list
  - added `#/components/schemas/VectorDocSearchUpdate, #/components/schemas/TextOnlyDocSearchUpdate, #/components/schemas/HybridDocSearchUpdate` to the `recall_options` request property `anyOf` list
  - added `#/components/schemas/VectorDocSearch, #/components/schemas/TextOnlyDocSearch, #/components/schemas/HybridDocSearch` to the `recall_options` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/RecallOptions` from the `recall_options` response property `anyOf` list for the response status `200`
- **2025-02-27** `bf9190a8aea0` — 1 breaking, 3 info
  - removed `#/components/schemas/VectorDocSearchUpdate, #/components/schemas/TextOnlyDocSearchUpdate, #/components/schemas/HybridDocSearchUpdate` from the `recall_options` request property `anyOf` list
  - added `#/components/schemas/RecallOptionsUpdate` to the `recall_options` request property `anyOf` list
  - added `#/components/schemas/RecallOptions` to the `recall_options` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/VectorDocSearch, #/components/schemas/TextOnlyDocSearch, #/components/schemas/HybridDocSearch` from the `recall_options` response property `anyOf` list for the response status `200`
- **2025-02-26** `e01e4f400de2` — 6 breaking, 3 info
  - the `recall_options/anyOf[subschema #1: VectorDocSearchUpdate]/max_query_length` request property's min was increased to `100.00`
  - the `recall_options/anyOf[subschema #2: TextOnlyDocSearchUpdate]/max_query_length` request property's min was increased to `100.00`
  - the `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/max_query_length` request property's min was increased to `100.00`
  - the `recall_options/anyOf[subschema #1: VectorDocSearch]/max_query_length` response property's max was increased from `1000.00` to `10000.00` for the response status `200`
  - the `recall_options/anyOf[subschema #2: TextOnlyDocSearch]/max_query_length` response property's max was increased from `1000.00` to `10000.00` for the response status `200`
  - the `recall_options/anyOf[subschema #3: HybridDocSearch]/max_query_length` response property's max was increased from `1000.00` to `10000.00` for the response status `200`
  - the `recall_options/anyOf[subschema #1: VectorDocSearchUpdate]/max_query_length` request property's max was increased from `1000.00` to `10000.00`
  - the `recall_options/anyOf[subschema #2: TextOnlyDocSearchUpdate]/max_query_length` request property's max was increased from `1000.00` to `10000.00`
  - the `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/max_query_length` request property's max was increased from `1000.00` to `10000.00`
- **2025-02-25** `1a338af95f85` — 3 breaking, 3 info
  - the `lang` response property const value `en-US` was removed for the status `200`
  - the `lang` response property const value `en-US` was removed for the status `200`
  - the `lang` response property const value `en-US` was removed for the status `200`
  - the `lang` request property const value `en-US` was removed
  - the `lang` request property const value `en-US` was removed
  - the `lang` request property const value `en-US` was removed
- **2025-02-25** `2f61540b4f3d` — 4 breaking, 6 warning
  - removed the required property `recall_options/anyOf[subschema #1: VectorDocSearch]/vector` from the response with the `200` status
  - removed the required property `recall_options/anyOf[subschema #2: TextOnlyDocSearch]/text` from the response with the `200` status
  - removed the required property `recall_options/anyOf[subschema #3: HybridDocSearch]/text` from the response with the `200` status
  - removed the required property `recall_options/anyOf[subschema #3: HybridDocSearch]/vector` from the response with the `200` status
  - removed the request property `recall_options/anyOf[subschema #1: VectorDocSearchUpdate]/text`
  - removed the request property `recall_options/anyOf[subschema #1: VectorDocSearchUpdate]/vector`
  - removed the request property `recall_options/anyOf[subschema #2: TextOnlyDocSearchUpdate]/text`
  - removed the request property `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/text`
  - removed the request property `recall_options/anyOf[subschema #3: HybridDocSearchUpdate]/vector`
  - removed the optional property `recall_options/anyOf[subschema #1: VectorDocSearch]/text` from the response with the `200` status
- **2025-02-24** `0ddb64e7a598` — 1 breaking, 3 info
  - removed `#/components/schemas/RecallOptionsUpdate` from the `recall_options` request property `anyOf` list
  - added `#/components/schemas/VectorDocSearchUpdate, #/components/schemas/TextOnlyDocSearchUpdate, #/components/schemas/HybridDocSearchUpdate` to the `recall_options` request property `anyOf` list
  - added `#/components/schemas/VectorDocSearch, #/components/schemas/TextOnlyDocSearch, #/components/schemas/HybridDocSearch` to the `recall_options` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/RecallOptions` from the `recall_options` response property `anyOf` list for the response status `200`
- **2025-02-18** `854c2437e2f6` — 1 breaking, 3 info
  - response property `system_template` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `system_template` request property default value `{%- if agent.name -%} You are {{agent.name}}.{{" "}} {%- endif -%} {%- if agent.about -%} About you: {{agent.about}}.{{" "}} {%- endif -%} {%- if user -%} You are talking to a user {%- if user.name -%}{{" "}} and their name is {{user.name}} {%- if user.about -%}. About the user: {{user.about}}.{%- else -%}.{%- endif -%} {%- endif -%} {%- endif -%} {{NEWLINE}} {%- if session.situation -%} Situation: {{session.situation}} {%- endif -%} {{NEWLINE+NEWLINE}} {%- if agent.instructions -%} Instructions:{{NEWLINE}} {%- if agent.instructions is string -%} {{agent.instructions}}{{NEWLINE}} {%- else -%} {%- for instruction in agent.instructions -%} - {{instruction}}{{NEWLINE}} {%- endfor -%} {%- endif -%} {{NEWLINE}} {%- endif -%} {%- if docs -%} Relevant documents:{{NEWLINE}} {%- for doc in docs -%} {{doc.title}}{{NEWLINE}} {%- if doc.content is string -%} {{doc.content}}{{NEWLINE}} {%- else -%} {%- for snippet in doc.content -%} {{snippet}}{{NEWLINE}} {%- endfor -%} {%- endif -%} {{"---"}} {%- endfor -%} {%- endif -%}` was removed
  - request property `system_template` list-of-types was widened by adding types `null` to media type `application/json`
  - the `system_template` response's property default value `{%- if agent.name -%} You are {{agent.name}}.{{" "}} {%- endif -%} {%- if agent.about -%} About you: {{agent.about}}.{{" "}} {%- endif -%} {%- if user -%} You are talking to a user {%- if user.name -%}{{" "}} and their name is {{user.name}} {%- if user.about -%}. About the user: {{user.about}}.{%- else -%}.{%- endif -%} {%- endif -%} {%- endif -%} {{NEWLINE}} {%- if session.situation -%} Situation: {{session.situation}} {%- endif -%} {{NEWLINE+NEWLINE}} {%- if agent.instructions -%} Instructions:{{NEWLINE}} {%- if agent.instructions is string -%} {{agent.instructions}}{{NEWLINE}} {%- else -%} {%- for instruction in agent.instructions -%} - {{instruction}}{{NEWLINE}} {%- endfor -%} {%- endif -%} {{NEWLINE}} {%- endif -%} {%- if docs -%} Relevant documents:{{NEWLINE}} {%- for doc in docs -%} {{doc.title}}{{NEWLINE}} {%- if doc.content is string -%} {{doc.content}}{{NEWLINE}} {%- else -%} {%- for snippet in doc.content -%} {{snippet}}{{NEWLINE}} {%- endfor -%} {%- endif -%} {{"---"}} {%- endfor -%} {%- endif -%}` was removed for the status `200`
- **2025-01-27** `f87931a479bd` — 1 warning, 13 info
  - removed the optional property `jobs` from the response with the `200` status
  - added the optional property `auto_run_tools` to the response with the `200` status
  - added the optional property `context_overflow` to the response with the `200` status
  - added the optional property `forward_tool_calls` to the response with the `200` status
  - added the optional property `kind` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added the optional property `recall_options` to the response with the `200` status
  - added the optional property `render_templates` to the response with the `200` status
  - added the optional property `situation` to the response with the `200` status
  - added the optional property `summary` to the response with the `200` status
  - added the optional property `system_template` to the response with the `200` status
  - added the optional property `token_budget` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - the response required property `id` became read-only for the status `200`
- **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`

---

[Operation](https://skmtc.dev/julep-ai/apis/julep-agents-api/docs/sessions/:session_id/patch.md) · [API](https://skmtc.dev/julep-ai/apis/julep-agents-api.md) · [Page](https://skmtc.dev/julep-ai/apis/julep-agents-api/changes/sessions/:session_id/patch)
