---
title: "POST /api/history"
method: POST
path: "/api/history"
tags: ["Ai.Tlbx.MidTerm.OpenApi"]
---

# POST /api/history

`POST /api/history`

## Request body

- CreateHistoryRequest
  - `shellType` string, required
  - `executable` string, required
  - `commandLine` string, nullable
  - `workingDirectory` string, required
  - `dedupeKey` string, nullable
  - `isStarred` boolean, required
  - `label` string, nullable
  - `notes` string, nullable
  - `launchMode` string, required
  - `profile` string, nullable
  - `launchOrigin` string, nullable
  - `surfaceType` string, required
  - `foregroundProcessName` string, nullable
  - `foregroundProcessCommandLine` string, nullable
  - `foregroundProcessDisplayName` string, nullable
  - `foregroundProcessIdentity` 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` — 2 info
  - added the new optional request property `launchOrigin`
  - added the required property `launchOrigin` to the response with the `200` status
- **2026-04-04** `329be4913b8b` — 1 breaking, 9 info
  - added the new required request property `surfaceType`
  - added the new optional request property `foregroundProcessCommandLine`
  - added the new optional request property `foregroundProcessDisplayName`
  - added the new optional request property `foregroundProcessIdentity`
  - …6 more
- **2026-03-27** `536b8636ac1e` — 7 breaking, 7 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
  - …10 more

[Change history](https://skmtc.dev/tlbx-ai/apis/tlbx-api/changes/api/history/post.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)