Automation

Start one durable run from one trigger receipt

Atomically consumes the one-time receipt, binds the current policy snapshot and runner credential, and reserves the run budget. Case-linked runs also require their lease token.

post/v1/projects/{project_id}/automation-runs

Request

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

Path parameters

project_idstring required

Headers

Idempotency-Keystring required

Stable 8-500 character command key. Preserve it only when replaying the exact same request; use a new key for a distinct command.

X-Agentry-Lease-Tokenstring

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

Request body

automation_idstring required
trigger_receipt_idstring required
case_idstring
claim_idstring

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.