Tasks

List scheduled tasks

Required API-key scope: tasks:read. Optional query filters include created_after / created_before (RFC3339, inclusive).

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.

page_token integer | null
page_size integer | null

200application/json

Paginated list of tasks

items object[] required
agent_object_id string | null
controller_address string | null
controller_agent_id string | null
controller_kind string required

address or agent — which controller_* field below is populated.

created_at string required
object_id string required
onchain_created_at string | null

Checkpoint timestamp of the on-chain creation event; null for rows projected before on-chain timestamps were indexed (until a backfill + replay fills them).

skill_id integer | null
status string required
updated_at string 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