topabaem05.github.io

falsify.ticket.claim

Claim one eligible ticket for this agent session and record why it was selected. A claimed ticket is removed from the eligible queue, so no one else works on it, and the reason is shown to the researcher next to the ticket. This changes queue ownership only; it starts nothing. Approval: in COPILOT and AUTORESEARCH modes this executes immediately. In MANUAL mode it executes nothing and returns status "approval_required" with an approval id; a researcher must approve it in the Falsify Approval Center first. 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
    },
    "ticket_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "reason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "agent_session_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 96
    },
    "expected_project_revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "project_id",
    "ticket_id",
    "reason",
    "idempotency_key",
    "expected_project_revision"
  ],
  "additionalProperties": false
}