topabaem05.github.io

falsify.run.cancel

Cancel a run that is queued or in flight. The run is recorded as CANCELLED and its partial work is discarded; compute already spent is not refunded. Approval: this always returns status "approval_required" for an agent caller, in every autonomy mode. A researcher must confirm it in the Falsify Approval Center. Send a fresh `idempotency_key` per intent — retrying with the same key and the same body replays the first response instead of acting twice — and `expected_project_revision` from the last state you read; a stale revision returns status "conflict" with the current one. Returns the Falsify envelope: { ok, status, projectRevision, result?, approval?, warnings?, nextActions? }. Branch on `status`, and carry `projectRevision` into the next mutation as `expected_project_revision`.

Page: /Falsify/

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "run_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "reason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 96
    },
    "expected_project_revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "project_id",
    "run_id",
    "reason",
    "idempotency_key",
    "expected_project_revision"
  ],
  "additionalProperties": false
}