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

[Full 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/04072327b4e0/schema)