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 ever bought automatically.
Credit 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.
Prices, invoices and your rights
Every price includes VAT, and the amount charged is the price shown. A checkout must carry the buyer's request to start at once, which is the box on the review page: without it the API answers 400 and opens no payment. Stripe issues an invoice for each payment, and you find it with the order in your account or wallet, or through GET /api/billing/orders.
A consumer can withdraw from a pack or a subscription within 14 days, with the Withdraw from this contract button beside the order or through POST /api/billing/withdraw. A pack is refunded for its unused credits, and a subscription ends at once and is refunded for the unused time. You can cancel a subscription online at any time, and it stays until the end of the month you paid for. The terms of service have the full rules.