Acquire/renew the presence lock
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).
/api/objects/{name}/{id}/workflow/lockAcquires 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).
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.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/objects/string/string/workflow/lock"{ "expiresAt": "2019-08-24T14:15:22Z"}Run a workflow action POST
Runs `submit` | `approve` | `reject` | `withdraw` | `cancel` | `forward`. RBAC-scoped, workitem-gated, atomic and audited. `forward` takes `{ to: { userId } }`; `approve`/`reject`/`withdraw` take `{ comment }`.
Release the presence lock DELETE
Releases the caller's presence lease (also drops any expired locks for the record).