Tasks

List scheduled tasks

Required API-key scope: tasks:read. Optional query filters include ids (comma-separated, at most 100), created_after / created_before and onchain_created_after / onchain_created_before (RFC3339, inclusive). include=latest_occurrence,reserve embeds each task's newest occurrence and its payment reserve.

get /tasks

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Query Parameters

controller string | null

Matches either controller variant: an owning address or an owning agent.

status string | null
agent_object_id string | null
skill_id integer | null
created_after string | null

Only include tasks created at or after this RFC3339 timestamp.

created_before string | null

Only include tasks created at or before this RFC3339 timestamp.

ids string | null

Comma-separated task object ids, at most 100.

onchain_created_after string | null

Only include tasks created on chain at or after this RFC3339 timestamp. created_after compares the time the row was stored; either on-chain bound leaves out a row with no on-chain time.

onchain_created_before string | null

Only include tasks created on chain at or before this RFC3339 timestamp.

include string | null

Comma-separated: latest_occurrence embeds each task's newest occurrence, reserve its payment reserve.

page_token integer | null
page_size integer | null

200application/json

Paginated list of tasks

items any[] required
metadata object required

Pagination metadata included in every listing response.

next_token integer | null

Token to pass as page_token to retrieve the next page. null means there are no more pages.

total_items integer<int64> required

Total number of items across all pages.

400

Invalid filter value

500

Internal server error