What is charged
A patch costs one update however many operations it holds. Retrying a request with the same idempotency key returns the first result and charges once.
What is free
- Checking a canvas before creating it (
validate_canvas), which also returns the price. - Reading canvases, answers, events, comments and notifications.
- Arranging a canvas, and changing its access, expiry, keep setting or deleting it.
- Shared state, examples, and saving or searching templates and components. Creating a canvas from a template is charged as a create.
- Everything people do on a canvas: opening it, working on it, commenting and answering. Asking the canvas’s agent is charged as above.
- Calls that components make to your data sources, and, for now, running canvas tools.
Who can manage billing
Credits belong to the organization, and every member’s agents spend from the same balance. Only Admins can add credits, change the daily spend cap, set key caps and see recent activity. Members do not see the Billing page. They see Available credits on the API keys page and can ask an Admin to add credits. See Organizations and members.Your balance
For Admins, the Billing page shows:- Credit balance. What you can spend now. An amount shown as reserved for requests in progress is held while a paid request runs, then settled.
- Add credits. Buy credits through Stripe Checkout.
- Daily spend cap. The most your account can spend in a day.
- Recent activity. Refills, daily usage, and any credits added, removed, expired or reversed.
get_balance.
Add credits
- Open Billing.
- Under Add credits, enter a refill amount, from $5 to $500.
- Select Continue to Stripe and complete the payment.
New accounts
New accounts join a waitlist. After you sign up, CanvasView asks what you want to use it for and how many credits you think you need for testing: $5, $50, $500 or $5,000. The amount is a request, not a guarantee. CanvasView reviews each account and emails you when yours is approved, with any credit it added. Until then the workspace stays closed, you cannot buy credits, and your agent can only read examples, skills and the kit reference, validate a canvas and read the balance. After approval you connect your agent, or skip that step, and the workspace opens. Once the account is open, an Admin can add credits at any time. Only the person who created the organization sees these steps. People who join later skip them.Daily spending cap
The daily cap limits what your organization spends each day. Days run from midnight to midnight UTC. Once the day’s spending reaches the cap, paid requests fail withspend_cap until the next day. Free actions keep working.
To change the cap:
- Open Billing.
- Under Daily spend cap, enter an amount.
- Select Save.
Billing emails
CanvasView sends a billing email when the organization’s spending reaches 80% of the daily cap, and when its balance falls below zero.When a request is refused
The full list of error codes is in the error reference.