Authentication

Bearer token、workspace context、request convention です。

Protected API endpoint は OAuth access token を要求します。

curl https://api.epismo.ai/v1/packs/search \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"type":"context","query":"onboarding"}'

Read endpoint には read scope、mutation endpoint には write scope が必要です。

Workspace context

Supported /v1 endpoint は workspaceId を query parameter として受け取ります。

curl "https://api.epismo.ai/v1/projects?workspaceId=<workspace-id>" \
  -H "authorization: Bearer $TOKEN"

省略した場合、request は token の default context または personal space で実行されます。

Request conventions

JSON body では content-type: application/json を送ります。
日付は YYYY-MM-DD です。
Create/update call は scope を使います。
Search call は scopes を使います。
Update は明記がない限り PATCH semantics です。