---
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

---

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