> ## 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.

# Actualizar Herramienta

> Actualiza los datos de una herramienta.

## Endpoint

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

**Autenticación**\
Requiere el encabezado `authorization:  <tu_token>`.

## Parámetros de Camino

| Nombre | Tipo   | Obligatorio | Descripción                            | Ejemplo      |
| ------ | ------ | ----------- | -------------------------------------- | ------------ |
| id     | string | Sí          | Identificador único de la herramienta. | TOOL\_123456 |

## Cuerpo de la Solicitud (JSON)

```json theme={null}
{
  "name": "Nueva Herramienta",
  "description": "Descripción actualizada",
  "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"
  }
}
```

## Ejemplo (cURL)

```bash theme={null}
curl -X PUT "https://gateway.orkeia.ai/tools/TOOL_123456"   -H "authorization:  <tu_token>"   -H "Content-Type: application/json"   -d '{
    "name": "Nueva Herramienta",
    "description": "Descripción actualizada",
    "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" }
  }'
```

## Respuestas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": {
    "id": "TOOL_123456",
    "name": "Nueva Herramienta",
    "description": "Descripción actualizada",
    "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 — Error del Servidor

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

### 400 — Error del Cliente

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

## Campos

| Campo             | Tipo                       | Descripción                                    |
| ----------------- | -------------------------- | ---------------------------------------------- |
| id                | string                     | ID de la herramienta.                          |
| name              | string                     | Nombre de la herramienta.                      |
| description       | string                     | Descripción de la herramienta.                 |
| code              | string                     | Código ejecutable asociado (cuando aplicable). |
| entryFunctionName | string                     | Función de entrada en `code`.                  |
| sectors           | string\[]                  | Sectores permitidos.                           |
| publisher         | string                     | Quien publicó/creó la herramienta.             |
| enabled           | boolean                    | Indica si está habilitada.                     |
| environments      | string\[]                  | Ambientes en los que está disponible.          |
| mcp               | objeto                     | Configuración MCP (cuando aplicable).          |
| mcp.url           | string                     | URL del MCP.                                   |
| mcp.transport     | 'sse' \| 'streamable-http' | Tipo de transporte MCP.                        |
| createdAt         | string                     | Fecha de creación en formato ISO 8601.         |