Developers · API v1

Management API para agentes

Crea agentes, actualiza instrucciones y sube documentos desde tu backend con API keys. Disponible desde el plan Starter.

Crear cuenta →Ver producto

Autenticación

Todas las peticiones requieren una API key en la cabecera Authorization.

Authorization: Bearer sk_live_...

Crea y revoca keys en el portal (Ajustes). La gestión de keys no forma parte de la API v1.

Endpoints

Base URL: https://portal.almanzor.cloud

Método
Ruta
GET
/api/v1/agents
POST
/api/v1/agents
GET
/api/v1/agents/{id}
PATCH
/api/v1/agents/{id}
DELETE
/api/v1/agents/{id}
GET
/api/v1/agents/{id}/documents
POST
/api/v1/agents/{id}/documents
DELETE
/api/v1/agents/{id}/documents/{docId}

Crear agente

curl -s -X POST "https://portal.almanzor.cloud/api/v1/agents" \
  -H "Authorization: Bearer $ALMANZOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "mi-agente",
    "name": "Mi agente",
    "instructions": "Eres un asistente útil...",
    "status": "active"
  }'

Subir documento

curl -s -X POST "https://portal.almanzor.cloud/api/v1/agents/{id}/documents" \
  -H "Authorization: Bearer $ALMANZOR_API_KEY" \
  -F "file=@./manual.pdf" \
  -F "mode=rag"

MCP (Claude Code / Cursor / Codex / VS Code)

Conecta Almanzor desde tu editor con el endpoint MCP remoto. Gestiona agentes sin instalar nada en tu máquina.

Configura tu cliente

Rellena los campos en la UI de tu editor o usa la configuración avanzada. Sustituye sk_live_... por tu API key del portal.

Antes de empezar

  1. Entra al portal con tu cuenta.
  2. Crea una API key en Ajustes
  3. Configura tu editor con la URL del endpoint y la key (header Bearer o variable de entorno).

Claude Code → terminal (claude mcp add)

Transport

http

URL

https://portal.almanzor.cloud/api/mcp

Header (key)

Authorization

Header (value)

Bearer sk_live_...

No uses Claude Desktop Connectors: requieren OAuth y no están soportados. Usa Claude Code en terminal.

Usa los campos de arriba o el comando CLI en la sección avanzada.

Tool
list_agents
get_agent
create_agent
update_agent
list_documents
delete_document
delete_agent

Endpoint: https://portal.almanzor.cloud/api/mcp. Requiere plan Starter o superior y una API key.

Códigos de error

400
Payload inválido o validación fallida
401
API key ausente o inválida
402
Plan sin acceso a la API (requiere Starter+)
404
Recurso no encontrado
409
Slug de agente ya en uso
429
Rate limit excedido (incluye cabecera Retry-After)
500
Error interno del servidor

Las respuestas de error incluyen un objeto JSON con el campo error. En 429, la cabecera Retry-After indica cuántos segundos esperar.