Dashboard

List and filter message previews by personal review progress

Review progress belongs to the authenticated manager and the current generated message. Every variant must be rated for a preview to be reviewed. Needs review includes unrated and partially rated previews. Undispatched previews without a written draft are left out of every view unless include_not_ready=true or preview_state is set; resolved, declined, sent, billing-held and expired rows stay visible. Filters apply before pagination and also apply to neighbor navigation. Summary feedback_counts ignore feedback_state while respecting the other filters, so selecting one status does not hide the other tab counts. view=to_review lists the review queue of the current messaging mode, oldest first: in calibration, drafts the signed-in manager has not fully rated; in manual mode, manual_pending drafts; in autonomous mode, none. counts.to_review is the exact queue size for the q and channel filters, on the first list page, on every queue page and on the summary. counts_only=true returns only total and counts (the sidebar badge).

get/dashboard/apps/{app_id}/message-previews

Request

  • Base URL: https://api.whisperr.net
  • URL: https://api.whisperr.net/dashboard/apps/{app_id}/message-previews
  • Auth: HTTP bearer

Path parameters

app_idstring required

whisp-go runtime app id or imported onboarding source_app_id.

Query parameters

feedback_state'needs_review' | 'partially_reviewed' | 'reviewed'
view'summary' | 'neighbors' | 'to_review'
anchorstring

Preview ID for neighbor navigation.

include_not_readyboolean

Also list previews without a written draft.

counts_onlyboolean

Return only total and counts, with no rows.

afterstring

Opaque next_cursor from the previous page of the same view. Offset is ignored when set.

limitinteger

0 returns only total and counts.

offsetinteger

Response

List returns data and total. Each row includes feedback_status and reviewed_variant_count. Summary returns groups, interventions, total, as_of, messaging_mode, and feedback_counts (all, needs_review, partially_reviewed, reviewed). Neighbors returns previous_id and next_id. Rows include resolution (success event code, label and time) when cancelled because their goal was completed, otherwise null.

next_cursorstring nullable

Pass as after for the next page. Null on the last page.

totalinteger

Changes

No recorded changes to this operation across all 1 revision of this API.