---
title: "Update Chat Session"
method: PATCH
path: "/v1/store/chat-sessions/{chat_session_id}"
tags: ["store"]
---

# Update Chat Session

`PATCH /v1/store/chat-sessions/{chat_session_id}`

## Path parameters

- `chat_session_id` string, required

## Request body

- UpdateChatSessionRequest
  - `title` string, nullable
  - `auto_suffix_title` boolean
  - `status` string, nullable
  - `status_message` string, nullable
  - `project_path` string, nullable
  - `slack_updates_enabled` boolean, nullable
  - `partition` string, nullable
  - `compute_traits` ComputeTraits — Abstract resource requirements for a task. All fields are optional; omitted fields impose no constraint.
    - `gpu_type` 'a10g' | 'l4' | 'a100' | 'h100' — Supported GPU families for compute requests.
    - `gpu_count` integer, nullable
    - `cpu_count` integer, nullable
    - `memory_gb` integer, nullable
    - `min_reservation_s` integer, nullable
    - `provider` string, nullable
  - `compute_assertion` ComputeAssertion — What a headless run demanded of its kernel, recorded for verification. Deliberately separate from the session's ``compute_traits`` rather than folded into it. Agent tools (``attach_notebook``, ``switch_notebook_kernel``) write ``compute_traits``, so a run that verified against that field would be checking whatever the agent last asked for instead of what the caller demanded. Nothing but the caller writes this, so it stays a faithful record of the original request. Its presence is what opts a session into enforcement; absent, kernel starts behave exactly as they always have.
    - `provider` string, nullable
    - `compute_traits` ComputeTraits — Abstract resource requirements for a task. All fields are optional; omitted fields impose no constraint.
      - `gpu_type` 'a10g' | 'l4' | 'a100' | 'h100' — Supported GPU families for compute requests.
      - `gpu_count` integer, nullable
      - `cpu_count` integer, nullable
      - `memory_gb` integer, nullable
      - `min_reservation_s` integer, nullable
      - `provider` string, nullable
  - `kernel_affinity` KernelAffinityValue — Modal placement affinity persisted for the deferred kernel start.
    - `same_environment_as_notebook_id` string, nullable
    - `same_kernel_as_notebook_id` string, nullable
  - `sandbox_environment` SandboxEnvironmentSpec — Per-request container image and data mounts for a sandbox.
    - `image_ref` string, nullable
    - `mounts` ObjectStoreMount[]
      - `uri` string, required
      - `mount_path` string, required
      - `read_only` boolean
    - `run_scope` string, nullable
  - `isolated_run` boolean, nullable
  - `lease_id` string, nullable
  - `rft_mode` boolean, nullable
  - `rft_deployment` string, nullable
  - `workspace_baseline` string[], nullable
  - `total_tokens` integer, nullable
  - `last_seq_at_api_call` integer, nullable
  - `last_turn_call_id` string, nullable
  - `last_turn_outcome` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `abf76937a751` — 12 warning, 3 info
  - the `compute_assertion/anyOf[subschema #1: ComputeAssertion]/compute_traits/anyOf[subschema #1: ComputeTraits]/cpu_count/anyOf[subschema #1]/` request property's max was set to `64.00`
  - the `compute_assertion/anyOf[subschema #1: ComputeAssertion]/compute_traits/anyOf[subschema #1: ComputeTraits]/gpu_count/anyOf[subschema #1]/` request property's max was set to `16.00`
  - the `compute_assertion/anyOf[subschema #1: ComputeAssertion]/compute_traits/anyOf[subschema #1: ComputeTraits]/memory_gb/anyOf[subschema #1]/` request property's max was set to `256.00`
  - the `compute_traits/anyOf[subschema #1: ComputeTraits]/cpu_count/anyOf[subschema #1]/` request property's max was set to `64.00`
  - …11 more
- **2026-09-13** `9130e4640e24` — 5 info
  - added the new optional request property `compute_assertion/anyOf[subschema #1: ComputeAssertion]/compute_traits/anyOf[subschema #1: ComputeTraits]/min_reservation_s`
  - added the new optional request property `compute_traits/anyOf[subschema #1: ComputeTraits]/min_reservation_s`
  - added the new optional request property `last_turn_call_id`
  - added the new optional request property `last_turn_outcome`
  - …1 more
- **2026-09-11** `b6d2db8786ed` — 1 info
  - added the new optional request property `kernel_affinity`
- **2026-08-21** `e99c1b6139c8` — 2 info
  - added the new optional request property `rft_deployment`
  - added the new optional request property `rft_mode`
- …earlier changes not shown

[Full history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/v1/store/chat-sessions/:chat_session_id/patch.md)

---

[API](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/revisions/d61e2ec5a271?raw)