---
title: "List team-defined HTTP tools on the voice agents (tools scope required)"
method: GET
path: "/api/v1/tools"
---

# List team-defined HTTP tools on the voice agents (tools scope required)

`GET /api/v1/tools`

## Request

- Base URL: `https://salestick-backend-647994203646.europe-central2.run.app`
- URL: `https://salestick-backend-647994203646.europe-central2.run.app/api/v1/tools`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Custom mid-call tools created via POST /api/v1/tools or the MCP create_agent_tool. Header values are masked. Built-in Canarics tools are not listed.

## Response `200`

Tools per agent

- object
  - `agents` object[]
    - `agentId` string
    - `agentName` string, nullable
    - `tools` object[]
      - `name` string
      - `description` string
      - `params` object[]
      - `method` string
      - `url` string
      - `headers` object: Values masked.
      - `responseFields` string[]
      - `timeoutMs` integer
      - `enabled` boolean
      - `createdAt` string, nullable
  - `note` string

## Other responses

- `403`: Key lacks the tools scope

---

[API](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents.md) · [All operations](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/revisions/e89711c2f1ba?raw)