SnozeDevelopers
API referenceBilling

Open a customer portal session for the workspace

Creates a Polar customer-portal session for the workspace and returns its URL, so the payer can manage payment methods and invoices with the provider. Requires a Clerk session and the `billing:manage` workspace permission.

POST
/v1/workspaces/{workspaceId}/billing/portal

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/workspaces/string/billing/portal'
Example Response
{  "data": {    "url": "string"  }}

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.

Cancel the workspace subscription

Cancels the workspace's subscription with the billing provider and returns the resulting subscription summary. Requires a Clerk session and the `billing:manage` workspace permission. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.