---
title: "Manage execution history"
method: POST
path: "/api/history"
tags: ["workflow"]
deprecated: true
---

# Manage execution history

`POST /api/history`

> **Deprecated.**

**Deprecated.** Superseded by the job-management endpoints under
`/api/jobs`. Planned for removal no earlier than a future major
release; sunset timeline TBD.

Clear all history for the authenticated user or delete specific job IDs.
Supports clearing all history or deleting specific job IDs.

## Request body

- HistoryManageRequest — Request to manage history operations
  - `clear` boolean — If true, clear all history for the authenticated user
  - `delete` string[] — Array of job IDs to delete from history

## Response `200`

Success - History management operation completed

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized - Authentication required
- `500` — Internal server error

## Changes

> 38 revisions in range; 2 could not be searched.

- **2026-06-03** `8560879e6188` — 1 warning, 5 info
  - deleted the `header` request parameter `Comfy-User`
  - api tag `workflow` added
  - api tag `history` removed
  - added the optional property `details` to the response with the `400` status
  - …2 more
- **2026-05-22** `09a5075587c8` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`
- **2026-04-24** `a66055fa384e` — 6 info
  - api tag `history` added
  - api tag `workflow` removed
  - added the new optional `header` request parameter `Comfy-User`
  - removed the non-success response with the status `400`
  - …2 more

[Change history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/history/post.md)

---

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