Living reports & observer room

Living client reports

A share link turns one study into a branded public microsite — findings, computed numbers, and an "ask this study" chat bounded to that study's data. The deliverable stops being a dead PDF.

curl -X POST "$BASE/api/v1/shares" -H "x-api-key: $MAVERA_API_KEY" \
  -H "content-type: application/json" -d '{
  "studyId": "study_...",
  "title": "Q3 Concept Test — Topline",
  "brandName": "Your Agency",
  "maxQuestions": 100
}'

The response includes the public URL (/r/{token}). What the client gets:

• The key finding, sections, and recommended actions
• A Q&A box whose answers come only from the study's persisted aggregates — every quoted number must exist in the data, and questions the study didn't measure get an honest "not covered"
• No login, no workspace access; the token is the capability

Revoke anytime with DELETE /api/v1/shares?id={token}. Question caps prevent runaway usage; each answered question meters to your workspace.

Observer room

Watch a focus group live — turns stream in as each persona speaks — and pass notes to the moderator mid-session, like standing behind the glass. Notes steer the next probe: "the observers want you to dig into price."

In the app: Observer (sidebar → Advanced). Via API:

curl -N "$BASE/api/v1/observer?audienceId=aud_...&topic=weeknight%20dinners&panelSize=5&rounds=3" -H "x-api-key: $MAVERA_API_KEY"

Events: session.started → panel → turn (per persona turn) → note.injected (when your note lands) → session.done → session.cost.

curl -X POST "$BASE/api/v1/observer" -H "x-api-key: $MAVERA_API_KEY" \
  -H "content-type: application/json" \
  -d '{"sessionId": "obs_...", "note": "push them on price"}'