# Shared Review Room

> Discuss one fixed reference with shared pinned comments in an expiring private room. Create an expiring room for text or a small PNG/JPEG reference, invite participants, resolve pinned comments and export the discussion. The owner can revoke the room.

Part of usefulweb.app (https://usefulweb.app/). Part of [Pageboard](https://pageboard.usefulweb.app/) (ownerApp: pageboard). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://pageboardreviewroom.usefulweb.app/ (interactive tool at https://pageboardreviewroom.usefulweb.app/tool)
- JSON API: POST https://pageboardreviewroom.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://pageboardreviewroom.usefulweb.app/api/v1/tool)
- OpenAPI: https://pageboardreviewroom.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://pageboardreviewroom.usefulweb.app/mcp - tool `pageboard_review_room`

## Inputs
- operation (select): Action
- title (textarea): Room title
- reference (textarea): Reference text or PNG/JPEG data URL
- hours (number): Room lifetime (hours)
- roomId (textarea): Room ID
- peer (textarea): Participant ID
- accessKey (textarea): Room access key
- ownerKey (textarea): Owner key
- participantKey (textarea): Private participant key
- name (textarea): Your display name
- comment (textarea): Comment
- commentId (textarea): Comment ID
- requestId (textarea): Idempotency key
- x (number): Pin X (%)
- y (number): Pin Y (%)

## Method
- Rooms retain one fixed text or PNG/JPEG reference, up to 200 comments and 100 participant identities for 1–24 hours. Anyone with the room access link can join and comment.
- A private participant key controls editing or resolving your own comments. The owner key additionally allows moderation and revocation. Display names are not verified identities.
- Participant and owner keys are separate from the invitation. Keys are stored as hashes. Expiry is enforced on every operation; pointer positions expire after 45 seconds.
- A repeated comment request with the same non-empty idempotency key does not append a second comment. This is review of a fixed reference, not simultaneous project editing.