SnozeDevelopers
API referenceWhats new

Read the What's New watermark for a channel

Returns the caller's read watermark for one release channel, along with the releases published after it. Scoped to the authenticated account rather than a workspace, so any authenticated caller may read their own state.

GET
/v1/me/whats-new/state/{channel}

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

channel*string
Value in"web""mobile"

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/me/whats-new/state/web'
Example Response
{  "data": {    "channel": "web",    "lastSeenReleaseId": "string",    "accountCreatedAt": "string"  }}

Draft a workspace from a description

Turns the caller's description of how they work into a proposed plan: a headline plus a shallow tree of folders, databases, pages, dashboards, and intake forms. The plan is a proposal only — nothing is created until an approved copy is applied to a workspace. Open to any authenticated caller because it runs before a workspace exists; the description is length-bounded and anything outside those bounds is a validation error.

Acknowledge What's New releases up to a release id

Moves the caller's watermark for a channel forward to the given release and returns the resulting state. Naturally idempotent: the watermark only ever moves forward, so replaying an ack is a no-op.