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

# Detalhar Ferramenta

> Retorna os detalhes de uma ferramenta específica.

## Endpoint

`GET https://gateway.orkeia.ai/tools/{id}`

**Autenticação**\
Requer cabeçalho `authorization:  <seu_token>`.

## Parâmetros de Caminho

| Nome | Tipo   | Obrigatório | Descrição                          | Exemplo      |
| ---- | ------ | ----------- | ---------------------------------- | ------------ |
| id   | string | Sim         | Identificador único da ferramenta. | TOOL\_123456 |

## Exemplo (cURL)

```bash theme={null}
curl -X GET "https://gateway.orkeia.ai/tools/TOOL_123456"   -H "authorization:  <seu_token>"
```

## Respostas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": {
    "id": "TOOL_123456",
    "name": "Ferramenta X",
    "description": "Descrição da ferramenta",
    "code": "export async function run(input){ return { ok: true }; }",
    "entryFunctionName": "run",
    "sectors": ["engineering"],
    "publisher": "Orkeia",
    "enabled": true,
    "environments": ["prod"],
    "mcp": {
      "url": "https://tools.orkeia.ai/my-tool",
      "transport": "sse"
    },
    "createdAt": "2024-07-15T14:25:18.000Z"
  }
}
```

### 500 — Server Error

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Client Error

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```

## Campos

| Campo             | Tipo                       | Descrição                                       |
| ----------------- | -------------------------- | ----------------------------------------------- |
| id                | string                     | ID da ferramenta.                               |
| name              | string                     | Nome da ferramenta.                             |
| description       | string                     | Descrição da ferramenta.                        |
| code              | string                     | Código executável associado (quando aplicável). |
| entryFunctionName | string                     | Função de entrada no `code`.                    |
| sectors           | string\[]                  | Setores permitidos.                             |
| publisher         | string                     | Quem publicou/criou a ferramenta.               |
| enabled           | boolean                    | Indica se está habilitada.                      |
| environments      | string\[]                  | Ambientes em que está disponível.               |
| mcp               | objeto                     | Configuração MCP (quando aplicável).            |
| mcp.url           | string                     | URL do MCP.                                     |
| mcp.transport     | 'sse' \| 'streamable-http' | Tipo de transporte MCP.                         |
| createdAt         | string                     | Data de criação no formato ISO 8601.            |