API referenceAdmin billing
Update a plan's entitlements
Changes the limits and entitlements attached to one plan. Platform admins only; an unknown plan is reported as not found and invalid entitlement values are rejected as a validation error.
PATCH
apiKeyheader
AuthorizationBearer <snoze_sk_…>Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
plan*stringValue in
"free""team""business""enterprise"application/json- body
name?string|nulltagline?string|nullbullets?array<string>|nullselfServe?boolean|nullmaxEditorSeats?number|null|nullmaxRecords?number|null|nullautomationRunsBasePerMonth?number|null|nullautomationRunsPerSeatPerMonth?number|nullmaxAutomations?number|null|nullmaxDashboards?number|null|nullmaxForms?number|null|nullmaxStorageBytes?number|null|nullhistoryRetentionDays?number|null|nullfeatures?array<string>|nullaiMonthlyBaseMicrousd?number|null|nullaiMonthlyPerSeatMicrousd?number|nullaiMonthlyPerFreeMemberMicrousd?number|nullaiRunCapMicrousd?number|null|nullaiMemberSharePercent?|null|nullaiGraceDailyMicrousd?number|nullaiOnboardingGrantMicrousd?number|nullreason?string|nullSuccess
application/json- response
data*Example Request
curl -X PATCH 'https://api.snoze.dev/v1/admin/billing/plans/free' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "data": { "plan": "free", "name": "string", "tagline": "string", "bullets": [ "string" ], "selfServe": true, "sortOrder": 0, "maxEditorSeats": 0, "maxRecords": 0, "automationRunsBasePerMonth": 0, "automationRunsPerSeatPerMonth": 0, "maxAutomations": 0, "maxDashboards": 0, "maxForms": 0, "maxStorageBytes": 0, "historyRetentionDays": 0, "features": [ "string" ], "aiMonthlyBaseMicrousd": 0, "aiMonthlyPerSeatMicrousd": 0, "aiMonthlyPerFreeMemberMicrousd": 0, "aiRunCapMicrousd": 0, "aiMemberSharePercent": 0, "aiGraceDailyMicrousd": 0, "aiOnboardingGrantMicrousd": 0 }}Update a billing price row
Changes an existing price and re-provisions its Polar product so the returned `polarProductId` stays current. Platform admins only; an unknown `priceId` is reported as not found.
Launch a pricing experiment
Creates the variant price rows for a pricing experiment, provisions their Polar products, and returns the experiment summary. Platform admins only; an invalid variant set is rejected as a validation error.