---
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-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
- **2026-03-27** `536b8636ac1e` — 7 breaking, 1 warning
  - removed the required property `foregroundProcessCommandLine` from the response with the `200` status
  - removed the required property `foregroundProcessDisplayName` from the response with the `200` status
  - removed the required property `foregroundProcessIdentity` from the response with the `200` status
  - removed the required property `foregroundProcessName` from the response with the `200` status
  - …4 more

[Change 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/cbbe49e2b3e2/schema)