Apps

Trigger a run (sync for rules/assisted; External parks at awaiting_decision)

Idempotent per (app, Idempotency-Key). dry_run produces a full trace and provably no side effects.

post/v1/apps/{id}/runs

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/apps/{id}/runs
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Query parameters

dry_run'true'

Headers

Idempotency-Keystring

Request body

inputobject
idempotency_keystring
dry_runboolean

Response

The run (projection shape).

run_idstring uuid
appstring

slug@vN

status'pending' | 'assembling' | 'awaiting_decision' | 'deciding' | 'verifying' | 'executing' | 'completed' | 'failed' | 'held' | 'cancelled'
modestring
dry_runboolean
triggerobject
decisionobject nullable
decided_byobject nullable

Actor union — rules / hosted_agent / human / external_agent recorded identically.

thresholds_appliedstring[]
reviewsstring[]
created_atstring date-time
completed_atstring date-time nullable

Changes

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