API

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から始めてください。同じ プレイブック、案件、タスク、記録、Suggestion 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