Tools

List tools

Required API-key scope: tools:read. Optional query filters include creator (hex wallet address that registered the tool), verified (on-chain verification flag), created_after / created_before (RFC3339, inclusive).

get /tools

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

fqn string | null

Filter by fully qualified name (substring match).

registered boolean | null

When true, only return registered (not unregistered) tools. When false, only return unregistered tools. Omit to return all.

kind enum<string>

Available options: http, sui

verified boolean | null

Filter by on-chain verification status. Rows projected before verification tracking have no value and match neither true nor false.

creator string | null

Filter by the wallet address that registered the tool (hex).

created_after string | null

Only include tools created at or after this RFC3339 timestamp.

created_before string | null

Only include tools created at or before this RFC3339 timestamp.

page_token integer | null
page_size integer | null

200application/json

Paginated list of tools

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

Sender of the first registration transaction — a re-registration does not change it. Null for rows projected before creator tracking (until a backfill + replay fills them).

description string required
fqn string required
is_registered boolean required
kind string required
location string required
lock_duration_ms integer | null

How long one invocation of this tool holds its lock, in milliseconds.

object_id string required

On-chain Tool object id.

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

registered_at string required
registry_object_id string | null

ToolRegistry object this tool is registered in.

unregistered_at string | null
updated_at string required
vault_balance_us integer | null

US collateral held in the tool's vault, snapshotted at the last registration or update read. A ToolSlashed lowers the on-chain vault without either event firing, so this can lag until the next update.

verified boolean | null

On-chain verification flag; null for rows projected before verification tracking (until a backfill + replay fills them). The same "null means unknown, not false" caveat applies to every field below it.

workflow_authorization_cap_first boolean | null

True when the tool's execute takes an Agent vertex authorization proof rather than the standard UIDRequirements signature.

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