topabaem05.github.io

falsify.run.start

Start a training run for a READY (or repairable) experiment node. This SPENDS the project's compute budget, executes the experiment and, when it finishes with valid metrics, freezes the node together with its evidence — a frozen node can never be edited again. The call returns as soon as the run is enqueued; poll `falsify.run.get` for the outcome. Approval: in MANUAL and COPILOT modes this executes nothing and returns status "approval_required" with an approval id — a researcher must approve it in the Falsify Approval Center before anything happens. Only AUTORESEARCH mode executes it immediately. 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"
    },
    "node_id": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "maxLength": 500
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 96
    },
    "expected_project_revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "project_id",
    "node_id",
    "reason",
    "idempotency_key",
    "expected_project_revision"
  ],
  "additionalProperties": false
}