Sign in
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

Request body

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.

Response

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.

Changes

Changed in 1 of the 172 revisions of this API.1

  • efc644ab09d41See the full diff
    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog