Tools API

Conceptual

Registry management, search and invocation records.

GET/v1/tools— List registered tools

POST/v1/tools— Register a custom tool

POST/v1/tools/search— Retrieve candidates for a goal

PATCH/v1/tools/{name}— Update schema, description or policy

DELETE/v1/tools/{name}— Deprecate a tool

GET/v1/tools/{name}/invocations— Invocation history with outcomes

Invocation record

{
  class="tok-str">"id": class="tok-str">"inv_4kd82",
  class="tok-str">"tool": class="tok-str">"inventory.lookup",
  class="tok-str">"run_id": class="tok-str">"run_7c1a9d",
  class="tok-str">"step_id": class="tok-str">"s3",
  class="tok-str">"status": class="tok-str">"ok",
  class="tok-str">"duration_ms": class="tok-num">412,
  class="tok-str">"retries": class="tok-num">0,
  class="tok-str">"arguments_hash": class="tok-str">"sha256:9f2c…",
  class="tok-str">"result_bytes": class="tok-num">2841,
  class="tok-str">"policy_decision": class="tok-str">"allow"
}

Last updated 2026-09-15