SnozeDevelopers
API referenceAuth

Resolve the Zero sync identity for the current session

Returns the caller's Clerk user id as `protocolUserId` alongside the internal Snoze user UUID, which the Zero sync client needs to address rows it owns. Requires a Clerk session with a synced Snoze profile; the internal user record is resolved on demand, so a session whose profile cannot be resolved fails.

GET
/v1/auth/zero-identity

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.

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/auth/zero-identity'
Example Response
{  "data": {    "protocolUserId": "string",    "internalUserId": "2852c4fe-0d69-43cc-ae1e-e4c7738bf00c"  }}

Read the authenticated actor for the current session

Returns the resolved actor for the current request, including the identity the rest of the API authorizes against. Requires a Clerk session with a synced Snoze profile; API keys are rejected.

Prepare a workspace billing PDF

Returns a fresh receipt or invoice PDF URL, generating an invoice when needed. Requires billing:read; the order must belong to this exact workspace. Send an Idempotency-Key for retries.