API

公開プレイブックの list/get は未認証でも利用できます。検索と保護された product route には OAuth Bearer access token が必要です。

public API は https://api.epismo.ai で提供されます。product operation は /v1、OAuth・OpenID Connect は /oauth と /.well-known endpoint を使います。protected product route は OAuth Bearer access token を受け取ります。

通常操作はCLIまたはMCPから始めてください。同じプレイブック、案件、タスク、記録、提案 model を、input validation と安全な context 処理付きで利用できます。product integration、OAuth client、backend service、CLI を呼べない別 surface を作る場合に HTTP API を使います。

この section で扱うこと

• PKCE 付き Authorization Code、refresh-token rotation、OpenID Connect、dynamic client registration、revocation、introspection、discovery metadata。
• first-party・manual flow の OTP exchange、専用 CLI・MCP token 発行。
• HTTP status、Bearer token、workspace context、pagination、idempotency、optimistic concurrency の規約。
• field-by-field schema を重複させず、integration plan に使える compact な endpoint map。

authorization endpoint を hard-code せず metadata から discover してください。

https://api.epismo.ai/.well-known/oauth-authorization-server
https://api.epismo.ai/.well-known/openid-configuration