Runs

Cancel Run

Cancels a pending, runnable, or running run. Pre-execution runs are cancelled synchronously. Live runs return after the cancellation request is durably recorded and continue converging to a terminal cancelled state. Returns 409 if the run has already completed or been cancelled.

post/api/v1/runs/{id}/cancel

Path parameters

idstring required

Unique run identifier (ULID).

Response

Run was cancelled synchronously before execution

idstring required

parent_idstring nullable

Current orchestration parent run ID, if linked.

children_countinteger required

Number of runs currently linked to this run as their orchestration parent.

titlestring required

goalstring required

labelsobject required

source_directorystring nullable required

size'XS' | 'S' | 'M' | 'L' | 'XL' required

Run size bucket derived from the run's current cost.

superseded_bystring nullable required

Run ID that superseded this run via rewind, if any.

retried_fromstring nullable required

Source run ID when this run was created by manual retry.

Example response

{
  "repository": {
    "name": "fabro-sh/fabro",
    "origin_url": "https://github.com/fabro-sh/fabro.git"
  },
  "lifecycle": {
    "error": {
      "message": "Stage 'apply-changes' exceeded maximum retries."
    }
  },
  "sandbox": {
    "plan": {
      "provider": "docker"
    },
    "instance": {
      "provider": "docker"
    }
  },
  "timing": {
    "wall_time_ms": 420000,
    "inference_time_ms": 120000,
    "tool_time_ms": 60000,
    "active_time_ms": 180000
  },
  "diff": {
    "files_changed": 42,
    "additions": 567,
    "deletions": 234
  },
  "pull_request": {
    "owner": "fabro-sh",
    "repo": "fabro",
    "number": 123,
    "html_url": "https://github.com/fabro-sh/fabro/pull/123"
  },
  "current_question": {
    "text": "Accept or push for another round?"
  }
}

Changes

Changed in 23 of the 172 revisions of this API.211983

Sep 19, 2026efc644ab09d46See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  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
Sep 14, 202657ca921cdd3822See the full diff
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 16 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 10, 2026478e995209e916See the full diff
- ○
  removed the daytona enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the daytona enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the daytona enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the daytona enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  the ////////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
- ○
  the ////////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
- ○
  the ////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
- ○
  the ////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 9, 202664d7e2ed03af124See the full diff
- ●
  added the new daytona enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new daytona enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new daytona enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new daytona enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new docker enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new docker enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new docker enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new docker enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new local enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new local enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new local enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new local enum value to the ////// response property for the response status
  response-property-enum-value-added
- ○
  the ////////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was removed for the status
  response-property-pattern-removed
- ○
  the ////////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was removed for the status
  response-property-pattern-removed
- ○
  the ////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was removed for the status
  response-property-pattern-removed
- ○
  the ////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was removed for the status
  response-property-pattern-removed
This revision also has 21 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 8, 20269aaa5d3a64cc16See the full diff
- ○
  removed the daytona enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the daytona enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the daytona enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the daytona enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the docker enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the local enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  the ////////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
- ○
  the ////////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
- ○
  the ////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
- ○
  the ////// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status
  response-property-pattern-added
This revision also has 24 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 31, 202618883371dc6f46See the full diff
- ▲
  removed the required property ////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////// from the response with the status
  response-required-property-removed
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the required property ////////// to the response with the status
  response-required-property-added
- ○
  added the required property ////////// to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 31, 20262ca60fd095f92See the full diff
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Jul 28, 2026ef906071a8e424See the full diff
- ●
  added the new publish_failed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new publish_failed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
Jul 28, 20267fe7b675579942See the full diff
- ▲
  the response property ///// became optional for the status
  response-property-became-optional
- ▲
  the response property ///// became optional for the status
  response-property-became-optional
- ▲
  the response property ///// became optional for the status
  response-property-became-optional
- ▲
  the response property ///// became optional for the status
  response-property-became-optional
- ○
  removed the publish_failed enum value from the ////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the publish_failed enum value from the ////// response property for the response status
  response-property-enum-value-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 20264f9aedeb721124See the full diff
- ●
  added the new publish_failed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new publish_failed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required

Full history (23 revisions)