Basis-URL
| Umgebung | URL |
|---|---|
| Produktion | https://api.commandagi.com |
Das Präfix /v1 ist optional: /v1/threads und /threads sind dieselbe Route.
Authentifizierung
Senden Sie einen API-Schlüssel als Bearer-Token:
curl https://api.commandagi.com/v1/me \
-H "Authorization: Bearer cagi_YOUR_KEY"- Schlüssel sehen aus wie
cagi_, gefolgt von 64 hexadezimalen Zeichen, und werden nur als Hashes gespeichert. - Erstellen und widerrufen Sie Schlüssel in der Werkbank im Kontomenü unter API-Schlüssel oder mit
GET/POST /me/api-keysundDELETE /me/api-keys/:keyId. Agenten erhalten eigene Schlüssel unter/agents/:id/keys. - Um für eine Ihrer Organisationen zu handeln, fügen Sie
x-cagi-account: <Konto-ID>hinzu. - WebDAV- und Git-Endpunkte akzeptieren denselben Schlüssel als Basic-Auth-Passwort.
Der Schlüssel eines Agenten wirkt im Konto seines Eigentümers, kann aber nie Befugnisse ändern: Routen, die Berechtigungen erstellen, Maschinen platzieren oder Eigentümer, Einstellungen oder Signierschlüssel ändern, antworten darauf mit 403 human_principal_required.
Dateien speichern, ohne Arbeit zu verlieren
Ein Schreibvorgang nennt die Version, die er ersetzt: Senden Sie If-Match: "<sha256>" mit dem Hash, den Sie gelesen haben, oder If-None-Match: *, um eine Datei zu erstellen, die noch nicht existieren darf. Wurde die Datei inzwischen geändert, antwortet die API mit 412, und nichts wird überschrieben.
Endpunkte
| Gruppe | Endpunkte |
|---|---|
| Konten | GET POST /accounts · GET /accounts/:id · GET PUT PATCH /accounts/:id/settings · GET /accounts/me/chain |
| Dauerberechtigungen | GET POST /accounts/:id/standing-grants · DELETE /standing-grants/:id · GET /standing-grants/held |
| Signierschlüssel | GET /accounts/:id/signing-key · POST /accounts/:id/signing-key/rotate |
| Hosts | GET /accounts/:id/hosts · POST /hosts/:hostId/call |
| Dateien | GET /drive · POST /drive/upload · GET PUT /drive/:id/content · PATCH DELETE /drive/:id · POST /drive/folders |
| Agenten | GET POST /agents · GET PATCH DELETE /agents/:id · GET PUT /default-agents |
| Unterhaltungen | GET /me/threads · POST /threads · GET PATCH DELETE /threads/:id · GET /threads/:id/events · POST /threads/:id/inject |
| Handel | GET /trading/venues · POST /trading/order · POST /trading/account · POST /trading/cancel |
| Modelle | GET /models · GET /models/catalog · GET /models/families |
| MCP | POST /mcp — siehe SDK und MCP |
| Zustand | GET /health |
Modelle
GET /models listet die Modelle auf, die Sie verwenden können, als { "models": [ … ] }; filtern Sie mit ?useCase=. Das eigene Modell ist commandagi/CommandAGI-000. Modelle anderer Anbieter werden mit ihren eigenen IDs aufgelistet, und Sie können pro Konto oder Organisation Ihren eigenen Anbieterschlüssel mitbringen.
Es gibt keinen OpenAI-kompatiblen Chat-Completions-Endpunkt; verwenden Sie Unterhaltungen.
Fehler
Der HTTP-Status sagt, was schiefging: 401 ohne gültigen Schlüssel, 403, wenn der Prinzipal dies nicht darf, 404, wenn es das nicht gibt oder Sie es nicht sehen dürfen, 412, wenn sich eine Datei während Ihrer Arbeit geändert hat.