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.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Value in
- "web"
- "mobile"
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/me/whats-new/state/web"{ "data": { "channel": "web", "lastSeenReleaseId": "string", "accountCreatedAt": "string" }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}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.