Saltar al contenido principal
PUT
/
tools
/
:id

​
Endpoint

PUT https://gateway.orkeia.ai/tools/{id} Autenticación
Requiere el encabezado authorization: <tu_token>.

​
Parámetros de Camino

NombreTipoObligatorioDescripciónEjemplo
idstringSíIdentificador único de la herramienta.TOOL_123456

​
Cuerpo de la Solicitud (JSON)

{
  "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)

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

response
{
  "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

{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}

​
400 — Error del Cliente

{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}

​
Campos

CampoTipoDescripción
idstringID de la herramienta.
namestringNombre de la herramienta.
descriptionstringDescripción de la herramienta.
codestringCódigo ejecutable asociado (cuando aplicable).
entryFunctionNamestringFunción de entrada en code.
sectorsstring[]Sectores permitidos.
publisherstringQuien publicó/creó la herramienta.
enabledbooleanIndica si está habilitada.
environmentsstring[]Ambientes en los que está disponible.
mcpobjetoConfiguración MCP (cuando aplicable).
mcp.urlstringURL del MCP.
mcp.transport’sse’ | ‘streamable-http’Tipo de transporte MCP.
createdAtstringFecha de creación en formato ISO 8601.