---
title: "PATCH /api/history/{id}"
method: PATCH
path: "/api/history/{id}"
tags: ["Ai.Tlbx.MidTerm.OpenApi"]
---

# PATCH /api/history/{id}

`PATCH /api/history/{id}`

## Path parameters

- `id` string, required

## Request body

- HistoryPatchRequest
  - `isStarred` boolean, nullable
  - `label` string, nullable
  - `notes` string, nullable

## Response `200`

OK

- LaunchEntry
  - `id` string, required
  - `shellType` string, required
  - `executable` string, required
  - `commandLine` string, nullable, required
  - `workingDirectory` string, required
  - `isStarred` boolean, required
  - `label` string, nullable, required
  - `notes` string, nullable, required
  - `lastUsed` string, date-time, required
  - `order` integer, required
  - `launchMode` string, required
  - `profile` string, nullable, required
  - `launchOrigin` string, nullable, required
  - `surfaceType` string, required
  - `foregroundProcessName` string, nullable, required
  - `foregroundProcessCommandLine` string, nullable, required
  - `foregroundProcessDisplayName` string, nullable, required
  - `foregroundProcessIdentity` string, nullable, required

## Changes

- **2026-05-06** `885b13067692` — 2 info
  - added the new optional request property `notes`
  - added the required property `notes` to the response with the `200` status
- **2026-04-25** `87834ab1254b` — 1 breaking, 1 warning
  - removed the required property `notes` from the response with the `200` status
  - removed the request property `notes`
- **2026-04-25** `cbbe49e2b3e2` — 2 info
  - added the new optional request property `notes`
  - added the required property `notes` to the response with the `200` status
- **2026-04-11** `fb825c8f76d7` — 1 info
  - added the required property `launchOrigin` to the response with the `200` status
- **2026-04-04** `329be4913b8b` — 5 info
  - added the required property `foregroundProcessCommandLine` to the response with the `200` status
  - added the required property `foregroundProcessDisplayName` to the response with the `200` status
  - added the required property `foregroundProcessIdentity` to the response with the `200` status
  - added the required property `foregroundProcessName` to the response with the `200` status
  - …1 more

[Full history](https://skmtc.dev/tlbx-ai/apis/tlbx-api/changes/api/history/:id/patch.md)

---

[API](https://skmtc.dev/tlbx-ai/apis/tlbx-api.md) · [All operations](https://skmtc.dev/tlbx-ai/apis/tlbx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tlbx-ai/tlbx-api/revisions/fbbda676c858/schema)