---
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
  - `status` string, nullable
  - `status_message` string, nullable
  - `project_path` string, 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
    - `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
      - `provider` 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
  - `total_tokens` integer, nullable
  - `last_seq_at_api_call` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/revisions/f797030c9050/schema)