> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar ferramentas utilizadas durante a chamada

> Recuperar todas as ferramentas utilizadas durante a chamada

Este endpoint permite que você recupere todas as ferramentas utilizadas durante a chamada. As ferramentas utilizadas durante a chamada permitem que seus assistentes de IA interajam com APIs externas durante uma chamada.

### Cabeçalhos

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Deve ser `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  Deve ser `application/json`
</ParamField>

### Campos de resposta

<ResponseField name="data" type="array">
  Array de ferramentas utilizadas durante a chamada

  <Expandable title="propriedades">
    <ResponseField name="id" type="integer">
      O identificador único da ferramenta
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome da ferramenta (minúsculas com sublinhados)
    </ResponseField>

    <ResponseField name="description" type="string">
      Explicação detalhada de quando e como a IA deve usar esta ferramenta
    </ResponseField>

    <ResponseField name="endpoint" type="string">
      A URL do endpoint da API que será chamado
    </ResponseField>

    <ResponseField name="method" type="string">
      Método HTTP (GET, POST, PUT, PATCH, DELETE)
    </ResponseField>

    <ResponseField name="timeout" type="integer">
      Timeout da solicitação em segundos (1-30)
    </ResponseField>

    <ResponseField name="headers" type="array">
      Cabeçalhos HTTP para enviar com a solicitação

      <Expandable title="propriedades de header">
        <ResponseField name="name" type="string">
          Nome do cabeçalho
        </ResponseField>

        <ResponseField name="value" type="string">
          Valor do cabeçalho
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="schema" type="array">
      Parâmetros que a IA extrairá e enviará para o endpoint

      <Expandable title="propriedades de schema">
        <ResponseField name="name" type="string">
          Nome do parâmetro
        </ResponseField>

        <ResponseField name="type" type="string">
          Tipo do parâmetro (string, number, boolean)
        </ResponseField>

        <ResponseField name="description" type="string">
          Descrição para ajudar a IA a entender como extrair este parâmetro
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp ISO 8601 de quando a ferramenta foi criada
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp ISO 8601 de quando a ferramenta foi atualizada pela última vez
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "get_weather",
      "description": "Use esta ferramenta para obter o clima atual em uma cidade específica. Chame isto quando o cliente perguntar sobre condições climáticas.",
      "endpoint": "https://api.openweathermap.org/data/2.5/weather",
      "method": "GET",
      "timeout": 10,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Bearer sk_..."
        }
      ],
      "schema": [
        {
          "name": "city",
          "type": "string",
          "description": "O nome da cidade para obter o clima"
        },
        {
          "name": "temperature",
          "type": "number",
          "description": "Valor da temperatura atual"
        },
        {
          "name": "is_raining",
          "type": "boolean",
          "description": "Se está chovendo atualmente"
        }
      ],
      "created_at": "2025-10-10T12:00:00.000000Z",
      "updated_at": "2025-10-10T12:00:00.000000Z"
    },
    {
      "id": 2,
      "name": "send_notification",
      "description": "Use esta ferramenta para enviar uma notificação ao cliente. Chame isto quando o cliente solicitar atualizações.",
      "endpoint": "https://api.suaempresa.com/notifications/send",
      "method": "POST",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "A mensagem de notificação a ser enviada"
        },
        {
          "name": "priority_level",
          "type": "number",
          "description": "Nível de prioridade de 1 a 5"
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Se também deve enviar notificação por SMS"
        }
      ],
      "created_at": "2025-10-09T14:30:00.000000Z",
      "updated_at": "2025-10-10T09:15:00.000000Z"
    }
  ]
  ```
</ResponseExample>

### Atribuindo Ferramentas a Assistentes

Para usar estas ferramentas com assistentes, veja:

* **[Criar Assistente](/api-reference/assistants/create-assistant)** - Anexe ferramentas usando o parâmetro `tool_ids`
* **[Atualizar Assistente](/api-reference/assistants/update-assistant)** - Gerencie atribuições de ferramentas usando o parâmetro `tool_ids`