Skip to main content
API reference sections

Schema

ArtifactDisposition

What a person said should happen to a deleted run's results.

A run that produced nothing is never asked. A run that did is, once, when it goes into the trash - and the answer waits there with it, because trashing changes nothing in the artifact store and emptying the trash is what acts.

Keep is the default and the safe one. A run with no answer recorded keeps what it produced: a build that predates the question, a recording that was lost, a run that arrived by sync. Nothing infers delete.

Type "keep" or "delete"

Shape

One of 2 shapes:

  1. Variant 1

    The results stay in the Artifacts column with their provenance intact. That provenance names a run that no longer exists, and the Artifact Store records the deletion so the sentence says the run was deleted rather than printing an id nothing resolves.

    "keep"

  2. Variant 2

    The results go with the run: every family the run created is retired. Their versions stay - a version is immutable and the store retires rather than erases - but the column stops offering them.

    "delete"

Example
"keep"

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

Generated from contract version 1. Last updated .

Privacy choices

Choose which optional tools Koru may use on this site. Your choice is saved in a cookie in this browser for 12 months. Privacy policy

Privacy choices

Keep you signed in, protect forms and remember your language and this choice.

Always on

PostHog and Google Analytics 4 measure page views and actions such as downloads, using cookies or local storage.

PostHog records how pages are used, with form inputs masked and private pages excluded. Needs Analytics.

Ahrefs Web Analytics measures visits and where they come from, and Google Ads measures whether our ads led to a visit or download.