talonic_list_agent_tasks
List Agent-stage tasks visible to the current workspace credential. The response contains task metadata and cursor pagination; payload data is deliberately fetched one task at a time so each disclosure can be audited.
Start the pull workflow
- Call
talonic_list_agent_taskswithstatus: "available". - Inspect a candidate with
talonic_get_agent_task. - Claim it with
talonic_claim_agent_taskbefore doing work. - Heartbeat while processing, then submit only fields declared in
output_contract.
| Parameter | Type | Description |
|---|---|---|
| status | available | claimed | submitted | timed_out | cancelled | Optional lifecycle-state filter. Start with `available` when looking for work. |
| limit | integer | Page size from 1 to 100. Defaults to 50. |
| cursor | string | Opaque `pagination.next_cursor` from the previous page. |
An empty worklist is normal: tasks exist only when a running document reaches an enabled Agent stage and the credential's Sources-IAM rules allow it.
Frequently asked questions
Does listing Agent tasks expose document data?+
No. The list returns metadata only. Fetching one task's immutable input snapshot uses talonic_get_agent_task and is recorded as an audited disclosure.