Sign in

v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0189112274.5 KB
task-retention

Clean Task

Delete content-bearing rows for a stale task.

Refuses on active tasks, in-flight workflows, or unprocessed events regardless of force. The force=true flag only bypasses the idle-threshold check.

post/tasks/{task_id}/clean

Path parameters

task_idstring required

Request body

forceboolean

Skip the idle-threshold check. Active-workflow and unprocessed-events checks still apply. Admin use only.

idle_daysinteger

Idle threshold in days (ignored when force=true).

Response

Successful Response

task_idstring required
cleaned_atstring date-time required
messages_deletedinteger required
task_states_deletedinteger required
events_deletedinteger required