Comment on a shared page through a share link
Adds a comment to one block of a shared page or note on behalf of an anonymous guest, attributed with the optional `guestName`; the block must belong to the shared surface and the body is trimmed to 4000 characters. Resolving the link here does not consume a use, so commenting is repeatable. No authentication; the share token in the path is the credential, and it must grant comment or edit access — anything else returns the same opaque not-found response.
token*stringapplication/json- body
blockId*stringbody*stringguestName?string|nullSuccess
application/json- response
data*curl -X POST 'https://api.snoze.dev/v1/public/shares/string/comment' \ -H 'Content-Type: application/json' \ -d '{ "blockId": "string", "body": "string"}'{ "data": { "id": "string" }}Mint a read-only realtime ticket for a shared item
Issues a short-lived, single-use ticket that lets the holder of a share link open a receive-only realtime connection for that item, so the page reflects edits without reloading. Requires the admitted-session grant returned by a consuming public read; reconnects reuse that grant without claiming another use. The path token alone is insufficient, and the response carries an opaque channel id rather than the token itself. A revoked, expired, or non-surface token returns the same opaque not-found.
List a file's share links
Returns the share links minted for one file with their expiry, use count and cap, download name, and revocation state. The raw token is never returned, so a listed link cannot be re-shared from here. Requires the `files:read` permission in the workspace.