Billing & Usage

Manage billing and usage. Find every run operation under Runs: lifecycle, events, input requests, children, the runs that triggers start, and the runtime callbacks workers use. Configure schedules and webhooks to trigger runs automatically. Use project queries for individual applications. Use account analytics to inspect conversation activity across the account, and Runs for account run analytics. Assign access through account and project roles. Private resources may require additional permissions. Inspect usage by account, project, member, or API key. Use budgets to cap monthly AI spend. Subscriptions · Billing · Credits · Budgets · Usage · Analytics

Subscriptions

Read owner-wide collaboration entitlements and seat usage. The project reference selects its owner; can_invite does not grant requester invitation permission. Read, upgrade, or cancel the account subscription. Create a checkout session or open the billing portal.

Endpoint	Methods	Description
`/account/subscription/checkout`	POST	Create checkout session
`/account/subscription/manage`	GET	Get billing portal URL
`/account/subscription`	GET	Get subscription
`/account/subscription/cancel`	POST	Cancel subscription
`/account/subscription/upgrade`	POST	Upgrade subscription
`/projects/{project_reference}/collaboration`	GET	Get available seats

Billing

Read financial records owned by the selected account. Read or update account billing details. List invoices and upcoming invoices. List, attach, detach, or select payment methods. List account payments.

Endpoint	Methods	Description
`/account/invoices`	GET	List billing invoices
`/account/upcoming-invoices`	GET	List upcoming billing invoices
`/account/payments`	GET	List billing payments
`/account/payment-methods`	GET, POST	List payment methods; Add payment method
`/account/payment-methods/{payment_method_id}`	PATCH, DELETE	Set default payment method; Remove payment method
`/account/billing-details`	GET, PATCH	Get billing details; Update billing details
`/accounts/{account_id}/subscription/checkout`	POST	Create account checkout session
`/accounts/{account_id}/credits/topup`	POST	Create account credit checkout
`/accounts/{account_id}/invoices`	GET	List account billing invoices
`/accounts/{account_id}/payments`	GET	List account billing payments
`/accounts/{account_id}/credits/packages`	GET	List account credit packages
`/accounts/{account_id}/credits/transactions`	GET	List account credit transactions
`/accounts/{account_id}/payment-methods`	GET, POST	List account payment methods; Add account payment method
`/accounts/{account_id}/upcoming-invoices`	GET	List account upcoming billing invoices
`/accounts/{account_id}/subscription/manage`	GET	Get account billing portal URL
`/accounts/{account_id}/billing-details`	GET, PATCH	Read account billing details; Update account billing details
`/accounts/{account_id}/credits/balance`	GET	Read account credit balance
`/accounts/{account_id}/subscription`	GET	Read account subscriptions
`/accounts/{account_id}/usage`	GET	Read account usage
`/accounts/{account_id}/payment-methods/{payment_method_id}`	PATCH, DELETE	Set account default payment method; Delete account payment method
`/accounts/{account_id}/subscription/cancel`	POST	Cancel account subscription
`/accounts/{account_id}/credits/coupons/redeem`	POST	Redeem account credit coupon
`/accounts/{account_id}/subscription/upgrade`	POST	Upgrade account subscription

Credits

Check the credit balance, review transactions, buy credits, or redeem a coupon.

Endpoint	Methods	Description
`/credits/topup`	POST	Create credit checkout
`/credits/packages`	GET	List credit packages
`/credits/transactions`	GET	List credit transactions
`/credits/balance`	GET	Get credit balance
`/credits/coupons/redeem`	POST	Redeem credit coupon

Budgets

Set monthly AI spending caps by project, person, API key, or a combination of these fields. New budgets count spending already incurred that month; use PATCH /budgets/{budget_id} to change an existing cap.

Endpoint	Methods	Description
`/budgets`	GET, POST	List budgets; Create budget
`/budgets/{budget_id}`	GET, PATCH, DELETE	Get budget; Update budget; Delete budget

Usage

Read account consumption, credit usage, limits, trends, and warnings. Use member usage for project AI spend by person and automation. AI usage analytics adds daily project or member consumption and customer charges. The project usage endpoint returns the project owner’s account-wide totals, not project-attributed usage. List usage across API keys or inspect one key. Manage the keys themselves through API key endpoints. Manage inference limits for project-bound keys.

Endpoint	Methods	Description
`/api-keys/usage`	GET	List API key usage
`/api-keys/{id}/limits`	GET, PUT, DELETE	Get API key inference limits; Replace API key inference limits; Clear API key inference limits
`/api-keys/{id}/usage`	GET	Get API key usage
`/account/usage/credits`	GET	Get account AI credits usage
`/account/usage/limits`	GET	Get account usage limits
`/account/usage`	GET	Get account usage overview
`/account/usage/series`	GET	Get account usage series
`/account/usage/warnings`	GET	Get account usage warnings
`/projects/{project_reference}/analytics/ai-usage`	GET	Get AI usage analytics
`/projects/{project_reference}/members/usage`	GET	Get member usage
`/projects/{project_reference}/usage`	GET	Get usage

Analytics

Start, list, inspect, cancel, and resume agent, task, and workflow runs, follow their events, answer their input requests, and find the runs that schedules, webhooks, and evaluations start. Read account-level conversation analytics. Find account run analytics under Runs. Use the Billing and Usage API for consumption and spending data.

Endpoint	Methods	Description
`/account/analytics/conversations`	GET	Get account conversation analytics
`/account/analytics/runs`	GET	Get run analytics

Back to REST API reference

Get started

APIs

REST API

GraphQL API

MCP API

Subscriptions

Billing

Credits

Budgets

Usage

Analytics

​Subscriptions

​Billing

​Credits

​Budgets

​Usage

​Analytics

Subscriptions

Billing

Credits

Budgets

Usage

Analytics