Read the workspace AI auto-refill settings
Returns the workspace's opt-in auto-refill preference and its monthly ceiling, the monthly top-up spend cap in cents, and what paid packs have cost this UTC month. Requires a Clerk session and the `billing:read` workspace permission.
apiKeyAuthorizationBearer <snoze_sk_…>Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
workspaceId*stringSuccess
application/json- response
data*curl -X GET 'https://api.snoze.dev/v1/workspaces/string/billing/ai-topups/settings'{ "data": { "autoRefillEnabled": true, "autoRefillMonthlyCeilingMicrousd": 0, "monthlySpendCapCents": 0, "spentThisMonthCents": 0 }}Open a checkout session for an AI top-up pack
Creates a Polar checkout session for a prepaid AI credit pack ($15 for 10,000 credits); the balance is credited later by the order webhook, not by this call. Requires a Clerk session with a synced profile and the `billing:manage` workspace permission. Refused as forbidden when top-ups are not available on the workspace's plan, when the pack is retired (`ai_topup_pack_retired`; retired packs only credit orders already paid), or when the purchase would pass the workspace's monthly top-up spend cap (`ai_topup_spend_cap`).
Update the workspace AI auto-refill settings
Updates whether auto-refill is enabled, its monthly ceiling, and the monthly top-up spend cap in cents (null removes the cap), recording the acting user; omitted fields are left unchanged. Requires a Clerk session and the `billing:manage` workspace permission.