v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB

System

Prune Runs

Deletes completed runs matching the provided filters, or previews the deletion set when dry-run is enabled.

post/api/v1/system/prune/runs

dry_runboolean

Preview matching runs without deleting them.

beforestring

Include runs started before this YYYY-MM-DD prefix.

workflowstring

Filter by workflow name substring.

labelsobject

Label filters applied with AND semantics.

orphansboolean

Include orphan run directories without run metadata.

older_thanstring

Include only runs older than this duration, such as 24h or 7d.

Prune result

dry_runboolean

Whether this response is a dry-run preview.

total_countinteger

Count of runs matching the prune filters.

total_size_bytesinteger

Total bytes of the matching runs.

deleted_countinteger

Number of runs deleted when dry-run is false.

freed_bytesinteger

Estimated freed bytes when deletion occurs.