SnozeDevelopers
API referenceAdmin billing

Attach a Polar subscription to a workspace

Links an existing Polar subscription to a workspace, deriving the plan from the subscription's product and recording the supplied `reason`. Platform admins only; a `subscriptionId` that is not present upstream is reported as not found.

POST
/v1/admin/billing/link

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.

Request Body

application/json
  1. body
workspaceId*string
subscriptionId*string
reason?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/admin/billing/link' \  -H 'Content-Type: application/json' \  -d '{  "workspaceId": "string",  "subscriptionId": "string"}'
Example Response
{  "data": {    "linked": true  }}

List Polar subscriptions not linked to a workspace

Returns the Polar subscriptions that exist upstream but are not yet attached to a Snoze workspace, joined with the plan each product maps to. Used for the migration flow. Platform admins only.

List workspaces with their operational state

Returns every workspace with its plan, limit overrides, and current AI usage, as shown on the admin operations screen. Platform admins only.