claim_work
/entities/{entity_id}/records/{record_id}/work/claimA candidate — named, or in a group or unit pool the work targets — takes
live, unclaimed work. On an entity whose claim setting is readers, so may
anyone whose Read scope reaches the record. Whether the caller may read the
record is decided first, so a caller who may not learns nothing about it.
A service principal's credential, or a person's access token, AgentFlow's own or an installed app's. A service principal's effective permissions are its role permissions intersected with the credential's scopes.
In: header
Path Parameters
Entity id
uuidRecord id
uuidResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08/records/497f6eca-6276-4993-bfeb-53cbbbba6f08/work/claim"{ "active": true, "assigned_group_ids": [ "4cee1a64-b703-4aef-a938-98b59ba36ecf" ], "assigned_unit_ids": [ "366d0120-aabd-4ba4-abdb-7f576a297ea7" ], "assigned_user_ids": [ "173e51c9-2537-489c-9d8b-ff125a6bd70d" ], "claimed_at": "2019-08-24T14:15:22Z", "claimed_by_user_id": "844949b6-eaeb-4229-906a-b1aa02fddcca", "record_id": "8bf519b6-a3e0-49d2-8e42-039542d9a489"}