URL de base
| environnement | URL |
|---|---|
| production | https://api.commandagi.com |
Le préfixe /v1 est facultatif : /v1/threads et /threads désignent la même route.
Authentification
Envoyez une clé d’API comme jeton au porteur :
curl https://api.commandagi.com/v1/me \
-H "Authorization: Bearer cagi_YOUR_KEY"- Les clés ressemblent à
cagi_suivi de 64 caractères hexadécimaux. Elles ne sont stockées que sous forme de hachages. - Créez et révoquez les clés dans l’atelier, depuis Clés d’API du menu du compte, ou avec
GET/POST /me/api-keysetDELETE /me/api-keys/:keyId. Les agents ont leurs propres clés sur/agents/:id/keys. - Pour agir au nom de l’une de vos organisations, ajoutez
x-cagi-account: <account id>. - Les points de terminaison WebDAV et Git acceptent la même clé comme mot de passe d’authentification Basic.
La clé d’un agent fonctionne dans le compte de son propriétaire, mais ne peut jamais modifier l’autorité. Les routes qui créent des autorisations, placent des machines ou modifient les propriétaires, les paramètres ou les clés de signature lui répondent 403 human_principal_required.
Enregistrer les fichiers sans perdre de travail
Une écriture nomme la version qu’elle remplace : envoyez If-Match: "<sha256>" avec le hachage que vous avez lu, ou If-None-Match: * pour créer un fichier qui ne doit pas encore exister. Si le fichier a changé entre-temps, l’API répond 412 et rien n’est écrasé.
Points de terminaison
| groupe | points de terminaison |
|---|---|
| comptes | GET POST /accounts · GET /accounts/:id · GET PUT PATCH /accounts/:id/settings · GET /accounts/me/chain |
| autorisations permanentes | GET POST /accounts/:id/standing-grants · DELETE /standing-grants/:id · GET /standing-grants/held |
| clés de signature | GET /accounts/:id/signing-key · POST /accounts/:id/signing-key/rotate |
| hôtes | GET /accounts/:id/hosts · POST /hosts/:hostId/call |
| fichiers | GET /drive · POST /drive/upload · GET PUT /drive/:id/content · PATCH DELETE /drive/:id · POST /drive/folders |
| agents | GET POST /agents · GET PATCH DELETE /agents/:id · GET PUT /default-agents |
| conversations | GET /me/threads · POST /threads · GET PATCH DELETE /threads/:id · GET /threads/:id/events · POST /threads/:id/inject |
| négociation | GET /trading/venues · POST /trading/order · POST /trading/account · POST /trading/cancel |
| modèles | GET /models · GET /models/catalog · GET /models/families |
| MCP | POST /mcp — voir SDK et MCP |
| santé | GET /health |
Modèles
GET /models liste les modèles que vous pouvez utiliser, sous la forme { "models": [ … ] } ; filtrez avec ?useCase=. Le modèle de première partie est commandagi/CommandAGI-000. Les modèles d’autres fournisseurs sont listés avec leurs propres identifiants, et vous pouvez apporter votre propre clé de fournisseur par compte ou par organisation.
Il n’existe pas de point de terminaison de complétions de chat compatible OpenAI ; utilisez les conversations.
Erreurs
Le code HTTP indique l’erreur : 401 sans clé valide, 403 lorsque le mandant n’a pas le droit de faire cela, 404 lorsque la ressource n’existe pas ou n’est pas à votre portée, 412 lorsqu’un fichier a changé pendant votre travail.