Run a workflow action
Runs `submit` | `approve` | `reject` | `withdraw` | `cancel` | `forward`. RBAC-scoped, workitem-gated, atomic and audited. `forward` takes `{ to: { userId } }`; `approve`/`reject`/`withdraw` take `{ comment }`.
/api/objects/{name}/{id}/workflow/{action}Runs submit | approve | reject | withdraw | cancel | forward. RBAC-scoped, workitem-gated, atomic and audited. forward takes { to: { userId } }; approve/reject/withdraw take { comment }.
Authorization
bearerAuth API key present in auth.source (or resolved by an AuthResolver).
In: header
Path Parameters
Object name from objects/<name>/schema.json.
Record id — the record_key encoding of the (possibly composite) primary key; returned as weave_id.
Declared workflow transition action name.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/objects/string/string/workflow/string"{}Admin override (jump to a node or terminate) PATCH
Admin-only (`admin` role). Body `{ node }` jumps the record to that node; `{ state: 'canceled' | 'finished' }` terminates it.
Acquire/renew the presence lock POST
Acquires a 60s presence lease on the caller's current workitem so withdraw/cancel is blocked while the record is being viewed; call again to renew (heartbeat).