Referencia de la API
Agentes y MCP
Leer el gasto y el ahorro por agente, llamar a herramientas a través de la pasarela MCP gobernada y ejecutar las herramientas de lectura del asistente.
Los resúmenes de las rutas y los nombres de los campos están en inglés, aquí y en el archivo.
/api/v1/agents
GET /api/v1/agents
Spend and savings per agent
Autenticación
Clave API
Ámbito de la clave
agents:readParámetros
daysRespuestas
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed, plan_required · 429/api/v1/mcp
GET /api/v1/mcp
Not used — the MCP gateway opens no stream (405)
Autenticación
Clave API
Ámbito de la clave
agents:writeMódulo
Disponible donde el despliegue ejecuta
FEATURE_MCP_GATEWAY.Respuestas
405POST /api/v1/mcp
The governed MCP gateway (Streamable HTTP, tools only)
Autenticación
Clave API
Ámbito de la clave
agents:writeMódulo
Disponible donde el despliegue ejecuta
FEATURE_MCP_GATEWAY.Cuerpo
application/jsonRespuestas
200 · 202 · 400 · 401 api_key_missing, api_key_invalid · 403 key_not_bound_to_agent, origin_not_allowed, api_key_scope_denied, plan_required · 429 · 500 internal_error · 501 feature_disabled · 503 feature_disabled, service_unavailableDELETE /api/v1/mcp
Not used — the MCP gateway keeps no session (405)
Autenticación
Clave API
Ámbito de la clave
agents:writeMódulo
Disponible donde el despliegue ejecuta
FEATURE_MCP_GATEWAY.Respuestas
405/api/v1/insights
POST /api/v1/insights/{tool}
Run one of the assistant's read tools
Autenticación
Clave API
Ámbito de la clave
insights:readMódulo
Disponible donde el despliegue ejecuta
FEATURE_ASSISTANT.Parámetros
tool (obligatorio)Cuerpo
input · localeRespuestas
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 assistant_disabled, api_key_scope_denied, plan_required · 404 unknown_tool · 429 · 500 internal_error · 501 feature_disabled · 503 service_unavailable