URL base
| entorno | URL |
|---|---|
| producción | https://api.commandagi.com |
El prefijo /v1 es opcional: /v1/threads y /threads son la misma ruta.
Autenticación
Envía una clave de API como token bearer:
curl https://api.commandagi.com/v1/me \
-H "Authorization: Bearer cagi_YOUR_KEY"- Las claves tienen la forma
cagi_seguida de 64 caracteres hexadecimales, y solo se almacenan como hashes. - Crea y revoca claves en el banco de trabajo desde claves de API en el menú de la cuenta, o con
GET/POST /me/api-keysyDELETE /me/api-keys/:keyId. Los agentes obtienen sus propias claves en/agents/:id/keys. - Para actuar como una de tus organizaciones, añade
x-cagi-account: <account id>. - Los endpoints WebDAV y Git aceptan la misma clave como contraseña de autenticación Basic.
La clave de un agente funciona dentro de la cuenta de su propietario, pero nunca puede cambiar la autoridad: las rutas que crean permisos, sitúan máquinas o cambian propietarios, ajustes o claves de firma le responden 403 human_principal_required.
Guardar archivos sin perder trabajo
Una escritura nombra la versión que reemplaza: envía If-Match: "<sha256>" con el hash que leíste, o If-None-Match: * para crear un archivo que aún no debe existir. Si el archivo cambió entretanto, la API responde 412 y no se sobrescribe nada.
Endpoints
| grupo | endpoints |
|---|---|
| cuentas | GET POST /accounts · GET /accounts/:id · GET PUT PATCH /accounts/:id/settings · GET /accounts/me/chain |
| permisos permanentes | GET POST /accounts/:id/standing-grants · DELETE /standing-grants/:id · GET /standing-grants/held |
| claves de firma | GET /accounts/:id/signing-key · POST /accounts/:id/signing-key/rotate |
| hosts | GET /accounts/:id/hosts · POST /hosts/:hostId/call |
| archivos | GET /drive · POST /drive/upload · GET PUT /drive/:id/content · PATCH DELETE /drive/:id · POST /drive/folders |
| agentes | GET POST /agents · GET PATCH DELETE /agents/:id · GET PUT /default-agents |
| hilos | GET /me/threads · POST /threads · GET PATCH DELETE /threads/:id · GET /threads/:id/events · POST /threads/:id/inject |
| operaciones de mercado | GET /trading/venues · POST /trading/order · POST /trading/account · POST /trading/cancel |
| modelos | GET /models · GET /models/catalog · GET /models/families |
| MCP | POST /mcp — consulta SDK y MCP |
| estado | GET /health |
Modelos
GET /models enumera los modelos que puedes usar, como { "models": [ … ] }; filtra con ?useCase=. El modelo propio es commandagi/CommandAGI-000. Los modelos de otros proveedores aparecen con sus propios ids, y puedes traer tu propia clave de proveedor por cuenta u organización.
No hay un endpoint de chat completions compatible con OpenAI; usa los hilos.
Errores
El estado HTTP indica qué salió mal: 401 sin una clave válida, 403 cuando el principal no puede hacer eso, 404 cuando no existe o no es tuyo para verlo, 412 cuando un archivo cambió mientras trabajabas.