Skip to main content
    Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Tools/GET /v1/tools

    GET /v1/tools

    List tools — The names-only tool catalogue: each tool's name, display name, category, one-line description, plan tier and whether it runs on a GPU.

    Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_…), a signed-in session token (Authorization: Bearer …) or the session cookie (browser sessions). See Authentication.

    The names-only tool catalogue: each tool's name, display name, category, one-line description, plan tier and whether it runs on a GPU. Needs an API key or a signed-in session; without one the call returns 401. Only tools this deployment offers are listed: deprecated, stopped and disabled tools are left out. Tools the agent uses for its own bookkeeping (memory, background tasks, delegation to sub-agents, planning and review) are not listed either.

    Parameter schemas are not part of this catalogue; read them from GET /api/v1/tools/{name}. Send If-None-Match with the last ETag to get a 304 when nothing has changed.

    Request

    Headers

    If-None-Matchstring

    The ETag from an earlier response.

    Responses

    200 OK

    The tool catalogue

    Response shape:

    countinteger
    generated_atstring (date-time)

    When the deployed tool catalog was generated. Fixed per deploy, so every instance returns the same value

    toolsobject[]

    304 Not Modified

    Unchanged since the If-None-Match ETag

    401 Unauthorized

    Authentication required

    Response shape: object

    429 Too Many Requests

    Rate limit exceeded

    Response shape: object

    curl -X GET 'https://ivybiosciences.com/api/v1/tools' \
      -H "Authorization: Bearer $IVY_API_KEY"

    Was this page helpful?

    Loading...