---
title: "Create Tool"
method: POST
path: "/v3/tools"
tags: ["Tools"]
---

# Create Tool

`POST /v3/tools`

Criar nova ferramenta para o agente de IA

## Request body

- CreateToolDto
  - `_id` string, required
  - `name` string, required — Nome da ferramenta
  - `description` string, required — Descrição da ferramenta para o agente entender seu propósito
  - `type` 'http_request' | 'function', required — Tipo da ferramenta
  - `httpConfig` object — Configuração para HTTP Request
  - `variableAssignments` string[] — Configuração para variáveis de atribuição no retorno da ferramenta

## Response `201`

---

[API](https://skmtc.net/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.net/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kinbox/kinbox-api/revisions/f5e8b22871e1/schema)