エンドポイント
Epismo HTTP API のエンドポイント一覧です。
保護された /v1 エンドポイントは、特に記載がない限り Authorization: Bearer <token> を要求します。多くのエンドポイントは、特定ワークスペースで実行するために workspaceId クエリパラメータも受け取ります。認証を参照してください。
Core API
| メソッド | パス | 用途 |
|---|---|---|
| GET | /v1/credits |
クレジット残高を取得 |
| POST | /v1/credits |
クレジットのチェックアウトを開始 |
| GET | /v1/workspaces |
アクセス可能なワークスペースを一覧 |
| POST | /v1/workspaces |
ワークスペースを作成 |
| PATCH | /v1/workspaces/:workspaceId |
ワークスペース設定を更新 |
| POST | /v1/workspaces/:workspaceId/checkout |
ワークスペースのチェックアウト URL を取得 |
| GET | /v1/workspaces/:workspaceId/members |
ワークスペースメンバーを一覧 |
| PUT | /v1/workspaces/:workspaceId/members |
ワークスペースメンバーを追加 / 更新 |
| DELETE | /v1/workspaces/:workspaceId/members |
ワークスペースメンバーを一括削除 |
| DELETE | /v1/workspaces/:workspaceId/members/:userId |
ワークスペースメンバーを1人削除 |
| GET | /v1/projects |
ワークスペース内のプロジェクトを一覧 |
| POST | /v1/projects |
プロジェクトを作成 |
| PATCH | /v1/projects/:projectId |
プロジェクトを更新 |
| DELETE | /v1/projects/:projectId |
プロジェクトを削除 |
| POST | /v1/projects/members/list |
複数プロジェクトのメンバーを一覧 |
| PUT | /v1/projects/:projectId/members |
プロジェクトメンバーを追加 |
| DELETE | /v1/projects/:projectId/members |
プロジェクトメンバーを一括削除 |
| DELETE | /v1/projects/:projectId/members/:userId |
プロジェクトメンバーを1人削除 |
| GET | /v1/agents |
エージェントカタログと active agents を一覧 |
| PUT | /v1/agents |
active roster にエージェントを追加 |
| DELETE | /v1/agents |
active roster からエージェントを削除 |
| POST | /v1/tracks |
タスクまたはゴールを作成 |
| GET | /v1/tracks/:id |
トラックを1件取得 |
| PATCH | /v1/tracks/:id |
トラックを1件更新 |
| POST | /v1/tracks/review |
読み取り専用のレビューを生成 |
| DELETE | /v1/tracks/:id |
トラックを1件削除 |
| POST | /v1/tracks/search |
トラックを検索 |
| POST | /v1/tracks/apply |
トラックの upsert/delete を一括適用 |
| POST | /v1/logs |
トラックにログを追記 |
| GET | /v1/logs |
1トラック、または見える全トラックのログを一覧 |
| DELETE | /v1/logs/:logId |
ログを1件削除 |
| POST | /v1/packs |
パックを作成 |
| GET | /v1/packs?reference=<ref> |
reference でパックを取得 |
| PATCH | /v1/packs?reference=<ref> |
reference でパックを更新 |
| DELETE | /v1/packs?reference=<ref> |
reference でパックを削除 |
| POST | /v1/packs/search |
パックを検索 |
| POST | /v1/packs/like |
パックを like / unlike |
| POST | /v1/packs/rate |
パックがうまくいったかを評価 |
| POST | /v1/packs/run |
ワークフロー・パックをゴールとタスクに展開 |
| PUT | /v1/aliases |
エイリアスを作成または付け替え |
| GET | /v1/aliases |
エイリアスを1件取得、または一覧 |
| DELETE | /v1/aliases/:alias |
エイリアスを削除 |
| POST | /v1/suggestions |
パック改善案を作成 |
| POST | /v1/suggestions/search |
改善案を一覧 / 検索 |
| GET | /v1/suggestions/:id |
改善案を1件取得 |
| PATCH | /v1/suggestions/:id |
改善案の title/content を更新 |
| PATCH | /v1/suggestions/:id/resolve |
改善案の status を解決 |
| POST | /v1/mcp/tokens |
MCP トークンを発行 |
| POST | /v1/mcp/tokens/refresh |
MCP トークンを更新 |
| POST | /v1/cli/tokens |
CLI トークンを発行 |
サインインと OAuth
| メソッド | パス | 用途 |
|---|---|---|
| POST | /v1/otp-tokens |
サインイン用の OTP トークンを作成 |
| POST | /oauth/token |
authorization code / refresh token をトークンへ交換 |
| GET/POST | /oauth/userinfo |
OpenID Connect user info |
| POST | /oauth/register |
Dynamic client registration |
| POST | /oauth/revoke |
access token / refresh token を失効 |
| POST | /oauth/introspect |
token の有効性と scopes を確認 |
| GET | /.well-known/oauth-authorization-server |
OAuth authorization server metadata |
| GET | /.well-known/openid-configuration |
OpenID Connect provider metadata |
互換性用 path
これらは古いクライアント向けに残っています。新しい連携では上の canonical route を使ってください。
| メソッド | パス | 互換性の内容 |
|---|---|---|
| PUT | /v1/workspaces |
非推奨の workspace upsert shape |
| PUT | /v1/projects |
非推奨の project upsert shape |
| PUT | /v1/tracks |
非推奨の track upsert shape |
| GET/PATCH/DELETE | /v1/packs/:id |
path に pack reference を置く legacy route |
| POST/GET/PATCH | /v1/packs/suggestions... |
/v1/suggestions... と同等の legacy suggestion path |