Credits
What each operation costs and how consumption works.
Credits meter successful operations across Playbooks, Cases, Tasks, Records, and Suggestions. Failed or invalid calls are never charged. A workspace has one shared balance regardless of seat count.
Credit bands
- 0 credits — Explore: List and get Public Playbooks. These reads are free on Web, CLI, and API, with or without login; MCP always requires login, but a Public Playbook read still costs 0 credits.
- 1 credit — Use: Private reads and lists, versions, drafts, stars, aliases, and Records.
- 2 credits — Coordinate: Change access, assignment, handoffs, lifecycle state, or a resolution.
- 5 credits — Create: Create or publish durable artifacts, start Cases, create Tasks or Suggestions, set an Alias, or run relevance search.
Public access on Web, CLI, and API is subject to fair-use rate limits. The CLI stores a random anonymous ID and sends it with requests; API clients can persist the X-Epismo-Anonymous-Id response header and send it on later requests. This ID is for analytics and rate limiting, not authentication or authorization.
Surface billing policies
- Public Playbook list/get: Free on every surface. Anonymous access returns Public data only.
- Search: Always 5 credits and requires authentication. Search is not part of the free Public browsing allowance.
- Web UI: Ordinary page loads and detail/list reads stay free. Search and writes use the normal price.
- API / CLI / MCP: Private reads and all authenticated operations use the operation price below.
Credit costs by operation
Playbook
| Operation | Cost |
|---|---|
playbook create |
5 credits |
playbook version publish, playbook draft publish |
5 credits |
playbook search (semantic and keyword search) |
5 credits |
playbook access set |
2 credits |
playbook archive, playbook version archive |
2 credits |
playbook share |
2 credits |
playbook list (private) |
1 credit |
playbook get (private) |
1 credit |
playbook version list |
1 credit |
playbook version get |
1 credit |
playbook draft get, draft save, draft discard |
1 credit |
playbook star, unstar |
1 credit |
playbook starred |
1 credit |
playbook creator stats |
1 credit |
playbook list (Public) |
Free (0 credits) |
playbook get (Public) |
Free (0 credits) |
playbook get is a continuation-oriented read. Its response includes the Playbook, its open Suggestions (open, applied, and declined), its recent Versions, and the aliases pointing at it. Those supporting reads are bundled into the same Playbook get — free for a Public Playbook, 1 credit for a private one — rather than charged separately; the ordinary Web detail page stays free either way.
Playbook Alias
| Operation | Cost |
|---|---|
playbook alias set |
5 credits |
playbook alias delete |
2 credits |
playbook alias list |
1 credit |
playbook alias resolve, reference resolution |
1 credit |
Playbook Suggestion
| Operation | Cost |
|---|---|
playbook suggestion create |
5 credits |
suggestion update |
2 credits |
suggestion resolve |
2 credits |
playbook suggestion list |
1 credit |
suggestion list |
1 credit |
suggestion get |
1 credit |
Case
| Operation | Cost |
|---|---|
case start |
5 credits |
case update |
2 credits |
case assign |
2 credits |
case acl |
2 credits |
case handoff create |
2 credits |
case close |
2 credits |
case reopen |
2 credits |
case list |
1 credit |
case handoff graph |
1 credit |
case handoff candidates |
1 credit |
case get |
1 credit |
case get is a continuation-oriented read. Its response includes the Case, current Tasks, Records from the Case and its ancestors, the direct handoff neighborhood, and the source Playbook and pinned Version when the reader can still access them. The supporting reads are bundled into one 1-credit Case get on API / CLI / MCP rather than charged separately; the ordinary Web detail page stays free.
Task
| Operation | Cost |
|---|---|
case task create |
5 credits |
task update |
2 credits |
task assign |
2 credits |
task close |
2 credits |
task reopen |
2 credits |
case task list |
1 credit |
task list |
1 credit |
task get |
1 credit |
Record
| Operation | Cost |
|---|---|
case record list |
1 credit |
case record append |
1 credit |
Insufficient balance
Higher-value operations are checked before execution. If the active personal or workspace balance is insufficient, the call fails with 402 Payment Required and is not charged. Lower-cost usage may appear as shortfall and is reclaimed from the next grant. Purchase more from Credit management, or switch to another context.