Agents

List agents

Required API-key scope: agents:read. Optional query filters: creator (hex wallet address that created the agent), owner (snapshotted Sui owner address), created_after / created_before (RFC3339, inclusive), page_token, page_size.

get /agents

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

creator string | null

Filter by the wallet address that created the agent.

owner string | null

Filter by the agent object's snapshotted Sui owner (wallet or object address).

created_after string | null

Only include agents created at or after this RFC3339 timestamp.

created_before string | null

Only include agents created at or before this RFC3339 timestamp.

page_token integer | null
page_size integer | null

200application/json

Paginated list of agents

items object[] required
created_at string required
creator string | null

Creation-transaction sender; not necessarily the current owner (agent custody is Sui object ownership and transfers emit no event).

current_owner string | null

Sui owner snapshot taken when the creation event was last (re)projected; null for shared/immutable custody or when the snapshot is missing.

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).

owner_kind string | null

Sui ownership variant of the snapshot (address, object, shared, immutable, consensus_address, unknown).

owner_refreshed_at string | null

When the owner snapshot was last applied.

tx_digest string required
updated_at string required
vault_object_id 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