PurgeRunResponse

POST /v1/runs/{run}/purge: the trash was emptied, and this run is gone.

Everything this device holds about it: the ledger's rows, its authority record, and its working folder when Koru made that folder. A run scoped to a project ran inside the person's own repository, and that directory was theirs before the run and is theirs after - folder says which of those happened, because a trash that quietly did less than it offered teaches somebody that it did more.

The Run document is not purged here: it is a document of the workspace's manifest, and the caller removes it once this has answered. Ordered that way deliberately - a folder the filesystem refuses is run_folder_not_removed with nothing changed, so the run stays in the trash and can be deleted again.

Type object

Shape

Field	Type	Description
runrequired	RunId
documentrequired	DocumentId	DocumentId - a client-minted v4 UUID, hyphenated and lowercase. Immutable, and never derived from a name or a path.
folderrequired	FolderOutcome	What emptying the trash did to a run's working folder. The trash says what it did, because an operation that quietly does less than it offered teaches a person that it did more. Three answers, and the middle one is the important one: a run scoped to a project ran inside a folder that was the person's before it started and is theirs after, so the run is forgotten and the directory is left exactly alone. A folder the filesystem refused to remove is not here: that refuses the whole deletion, so the run stays in the trash and can be deleted again.
artifacts_retiredrequired	integer (uint32, >= 0)	How many result families were retired because the person asked for them to go with the run. Zero when they asked to keep them, and for a run that produced nothing.

Example

{
  "run": "00000000-0000-4000-8000-000000000000",
  "document": "00000000-0000-4000-8000-000000000000",
  "folder": "removed",
  "artifacts_retired": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/runs/{run}/purge
The trash was emptied: delete the run

Generated from contract version 1. Last updated November 12, 2026.