List Tasks
onfleet.list_tasks
ActionBusiness appsconnection required
Calls the Onfleet API with the connection's credentials.
Read one page of the organisation's tasks from a starting time.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Onfleet
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
6 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
from_time The start of the search window, as a Unix timestamp in milliseconds. Completed tasks are matched on completion time, everything else on creation time. | number | Yes | — | ≥ 0 | 1767225600000 |
to_time The end of the search window, as a Unix timestamp in milliseconds. Leave blank for 'up to now'. | number | No | — | ≥ 0 | 1767261600000 |
last_id The cursor from a previous page's 'last_id' output. Pass it back to read the next page. | string | No | — | — | — |
state Only tasks in these states, as a comma-separated list: 0 unassigned, 1 assigned, 2 active, 3 completed. | string | No | — | — | 0,1 |
worker Only tasks currently assigned to, or already completed by, this worker id. | string | No | — | — | — |
dependencies Only tasks that depend on at least one of these task ids, as a comma-separated list. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"from_time": 1767225600000,
"state": "0,1",
"to_time": 1767261600000
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
items The records on this page, exactly as Onfleet returned them. | array | — |
count How many records are on this page. | number | — |
last_id The cursor to pass back for the next page. | string | — |
has_more Whether Onfleet has another page after this one. | boolean | — |
items[].id A task's Onfleet id. | string | — |
items[].shortId That task's dashboard short id. | string | — |
items[].state That task's state. | number | — |
items[].worker The worker that task is assigned to. | string | — |
items[].trackingURL That task's public tracking link. | string | — |
{
"count": 0,
"has_more": false,
"items": [
{
"id": "",
"shortId": "",
"state": 0,
"trackingURL": "",
"worker": ""
}
],
"last_id": ""
}Notes
- Onfleet returns at most 64 tasks per call. Keep paging while 'has_more' is true, passing 'last_id' back in.
Related Onfleet nodes
See List Tasks run in a workflow.
In a technical demo we add the Onfleet connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.