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

# Patch Session

`PATCH /api/sessions/{session_id}`

Update the title or status of a session within the authenticated user's workspace.

Parameters:
    body (SessionPatchRequest): Fields to update; at least one field is required.

Returns:
    SessionDetailResponse: The updated session details.

Raises:
    HTTPException: If no fields are provided, the title is blank, the status is invalid, or the
        session cannot be updated.

## Path parameters

- `session_id` string, uuid, required

## Request body

- SessionPatchRequest
  - `title` string, nullable
  - `status` 'active' | 'archived', nullable

## Response `200`

Successful Response

- SessionDetailResponse — Session detail — same public shape as the summary today.
  - `id` string, uuid, required
  - `title` string, required
  - `status` 'active' | 'archived', required
  - `checkpoint_version` integer, required
  - `created_at` string, nullable
  - `updated_at` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-17** `655778279cb1` — 1 info
  - endpoint added
- **2026-07-17** `62e8c152aa18` — 1 breaking
  - api path removed without deprecation
- **2026-07-15** `216311cd30ec` — 3 warning
  - deleted the `header` request parameter `Authorization`
  - deleted the `header` request parameter `X-Fleet-User-Id`
  - deleted the `header` request parameter `X-Fleet-Workspace-Id`
- **2026-07-13** `f18c4c8586ca` — 2 breaking, 3 warning, 5 info
  - request property `status/anyOf[subschema #1]/` was restricted to a list of enum values
  - removed the required property `turn_count` from the response with the `200` status
  - removed the optional property `detail` from the response with the `422` status
  - added the new `active` enum value to the `status` response property for the response status `200`
  - …6 more
- **2026-07-13** `1afc045b25c0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/sessions/:session_id/patch.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/3e0490b230d7/schema)