Automation

Apply one allowed run state transition

The server validates the immutable policy, evidence, budget, current switch, and case lease. The caller cannot mark deploy verification successful through this endpoint.

patch/v1/automation-runs/{run_id}

Request

  • Base URL: https://api.agentry.sh
  • URL: https://api.agentry.sh/v1/automation-runs/{run_id}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

run_idstring required

Headers

X-Agentry-Lease-Tokenstring

Required for a case-linked run. Omit only for schedule/alert runs that have no case claim.

Request body

status'running' | 'failed' | 'escalated' | 'cancelled' required
summary_mdstring

Response

OK

idstring required
project_idstring required
automation_idstring required
case_idstring nullable required
case_revisioninteger nullable required
trigger_kind'alert' | 'unhandled_cases' | 'schedule' required
trigger_receipt_idstring required
request_hashstring required
attemptinteger required
status'queued' | 'claimed' | 'running' | 'draft_pr_opened' | 'awaiting_approval' | 'verifying' | 'succeeded' | 'failed' | 'escalated' | 'cancelled' required
started_atinteger nullable required
finished_atinteger nullable required
created_atinteger required
updated_atinteger required
idempotent_replayboolean
next_actionstring

Changes

No recorded changes to this operation across all 1 revision of this API.