Agents

List scheduled tasks bound to an agent

Required API-key scope: agents:read.

get /agents/{agent_object_id}/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.

Path Parameters

agent_object_id string required

Agent object id

Query Parameters

page_token integer | null

Opaque token representing the page offset. Omit for the first page.

page_size integer | null

Maximum number of items to return. Defaults to 20.

200application/json

Paginated list of scheduled 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.

404

Agent was not found

500

Internal server error