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. 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 · Feature gates · Budgets · Usage · Analytics

Subscriptions

Read usage, activity and financial records owned by the selected account. Read owner-wide collaboration entitlements and seat usage. The project reference selects its owner; can_invite does not grant requester invitation permission.

Endpoint	Methods	Description
`/accounts/{account_id}/subscription`	GET, PATCH	Get subscription; Update subscription
`/accounts/{account_id}/subscription/cancel`	POST	Cancel subscription
`/accounts/{account_id}/billing-portal-sessions`	POST	Create billing portal session
`/projects/{project_reference}/collaboration`	GET	Get available seats

Billing

Read usage, activity and financial records owned by the selected account.

Endpoint	Methods	Description
`/accounts/{account_id}/billing-details`	GET, PATCH	Get billing details; Update billing details
`/accounts/{account_id}/invoices`	GET	List invoices
`/accounts/{account_id}/payments`	GET	List payments
`/accounts/{account_id}/payment-methods`	GET	List payment methods

Credits

Read usage, activity and financial records owned by the selected account.

Endpoint	Methods	Description
`/accounts/{account_id}/credits/balance`	GET	Get credit balance
`/accounts/{account_id}/credits/transactions`	GET	List credit transactions
`/accounts/{account_id}/credits/packages`	GET	List credit packages
`/accounts/{account_id}/credits/checkouts`	POST	Create credit checkout
`/accounts/{account_id}/credits/coupons/redeem`	POST	Redeem credit coupon

Feature gates

Check access to a named plan or feature gate. Individual endpoints still enforce their resource permissions.

Endpoint	Methods	Description
`/feature-gates/{gate}`	GET	Check feature gate

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 usage, activity and financial records owned by the selected account. Use member usage for project AI spend by person and automation. AI usage analytics adds daily project or member consumption and customer charges. 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
`/accounts/{account_id}/usage`	GET	Get usage
`/accounts/{account_id}/usage/series`	GET	Get usage series
`/accounts/{account_id}/usage/credits`	GET	Get credit usage
`/projects/{project_reference}/analytics/ai-usage`	GET	Get AI usage analytics
`/projects/{project_reference}/members/usage`	GET	Get member 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 usage, activity and financial records owned by the selected account.

Endpoint	Methods	Description
`/accounts/{account_id}/analytics/conversations`	GET	Get conversation analytics
`/accounts/{account_id}/analytics/runs`	GET	Get account run 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

Feature gates

Budgets

Usage

Analytics

​Subscriptions

​Billing

​Credits

​Feature gates

​Budgets

​Usage

​Analytics

Subscriptions

Billing

Credits

Feature gates

Budgets

Usage

Analytics