ベース URL
| 環境 | URL |
|---|---|
| 本番 | https://api.commandagi.com |
/v1 の接頭辞は省略できます。/v1/threads と /threads は同じルートです。
認証
API キーをベアラートークンとして送ります。
curl https://api.commandagi.com/v1/me \
-H "Authorization: Bearer cagi_YOUR_KEY"- キーは
cagi_に続けて 64 文字の 16 進数です。保存されるのはハッシュだけです。 - キーの作成と取り消しは、ワークベンチのアカウントメニューの API キー から行えます。または
GET/POST /me/api-keysとDELETE /me/api-keys/:keyIdを使います。エージェントは/agents/:id/keysで自分のキーを持ちます。 - 所属する組織として操作するには、
x-cagi-account: <アカウント ID>を追加します。 - WebDAV と Git のエンドポイントは、同じキーを Basic 認証のパスワードとして受け付けます。
エージェントのキーは、その所有者のアカウントの中で動けますが、権限を変えることはできません。付与の作成、マシンの配置、所有者・設定・署名鍵の変更を行うルートは、そのキーに 403 human_principal_required で答えます。
作業を失わずにファイルを保存する
書き込みでは、置き換える版を指定します。読んだハッシュを使って If-Match: "<sha256>" を送るか、まだ存在してはならないファイルを作るために If-None-Match: * を送ります。その間にファイルが変わっていた場合、API は 412 で答え、何も上書きされません。
エンドポイント
| グループ | エンドポイント |
|---|---|
| アカウント | GET POST /accounts · GET /accounts/:id · GET PUT PATCH /accounts/:id/settings · GET /accounts/me/chain |
| 常設の権限付与 | GET POST /accounts/:id/standing-grants · DELETE /standing-grants/:id · GET /standing-grants/held |
| 署名鍵 | GET /accounts/:id/signing-key · POST /accounts/:id/signing-key/rotate |
| ホスト | GET /accounts/:id/hosts · POST /hosts/:hostId/call |
| ファイル | GET /drive · POST /drive/upload · GET PUT /drive/:id/content · PATCH DELETE /drive/:id · POST /drive/folders |
| エージェント | GET POST /agents · GET PATCH DELETE /agents/:id · GET PUT /default-agents |
| 会話 | GET /me/threads · POST /threads · GET PATCH DELETE /threads/:id · GET /threads/:id/events · POST /threads/:id/inject |
| 取引 | GET /trading/venues · POST /trading/order · POST /trading/account · POST /trading/cancel |
| モデル | GET /models · GET /models/catalog · GET /models/families |
| MCP | POST /mcp — SDK と MCP を参照 |
| 状態確認 | GET /health |
モデル
GET /models は、使えるモデルを { "models": [ … ] } の形で一覧にします。?useCase= で絞り込めます。自社のファーストパーティモデルは commandagi/CommandAGI-000 です。ほかのプロバイダーのモデルは、それぞれの ID で一覧に出ます。アカウントまたは組織ごとに、自分のプロバイダーキーを持ち込めます。
OpenAI 互換の chat-completions エンドポイントはありません。会話を使ってください。
エラー
HTTP ステータスが問題の内容を示します。401 は有効なキーがないこと、403 はそのプリンシパルにこの操作が許されないこと、404 は対象が存在しないか、見る権利がないこと、412 はファイルが途中で変わったことを示します。