Credits, limits and usage
Understand account capacity, metered operations and execution quotes.
Separate three kinds of limits
| Limit | What the code applies |
|---|---|
| Credit balance | One balance per account. 100 credits at signup, then 100 credits every day once the email is verified. Credits never expire. |
| Account capacity | Up to 5 agents and 5 spaces per account, and up to 500,000 stored objects per agent. |
| Scheduling priority | An optional subscription that buys queue order under load. It adds no credits and no capacity. |
What costs credits
| Operation | Price |
|---|---|
Start a process instance (POST /api/v1/process-instances) | 1 credit |
Start a CMMN case (POST /api/v1/cases) | 1 credit |
Evaluate a decision (POST /api/v1/decisions/{id}/evaluate) | 1 credit |
Deploy a model with POST /api/v1/models | 1 credit, refunded if the deploy fails |
Complete a user task with POST /api/v1/tasks/{id}/complete | 1 credit |
Deploy BPMN with POST /api/v1/process-definitions; activate, complete or fail a job; every read | Free |
| A PAOL run | 1 credit per action its net fires, quoted before the run |
| Agent memory | 1 credit per space per hour, and 1 credit per full 100 queries on the owner's spaces, charged each hour |
| Connectors | Free: they are stored, not executed |
When the balance is too low, charged workflow calls answer 402 until the next daily grant or a pack restores it. Agent memory never answers 402: an hour the balance cannot cover is not charged, and the agents keep working. No pack is bought automatically unless you turn on auto top-up.
Credit packs
JSON · GET /api/credits/packs
{
"packs": [
{"id": "small", "credits": 5556, "price_cents": 500},
{"id": "medium", "credits": 22223, "price_cents": 2000},
{"id": "large", "credits": 55556, "price_cents": 5000}
]
}GET /api/credits/packs needs no key and answers an object with a packs array. Packs are one-off: Small €5 for 5,556 credits, Medium €20 for 22,223 and Large €50 for 55,556. Each pack is priced at 10% off the base rate of €1 for 1,000 credits, rounded up to the next whole credit. A pack renews nothing and changes no capacity.
Review the current terms
Pricing and estimator · Live walletMachine-readable contracts: MCP tools JSON · OpenAPI JSON. See the contract notes for older examples.
CONTINUE READINGMigrate a process with evidence →