System

Prune Runs

Changed on

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

post/api/v1/system/prune/runs

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in cookie __fabro_session

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