Approved content derived from voting (Read path). Computes winners, serves SSR page data, and provides moderation tools.
Trigger consensus recomputation for an entity
Recomputes winning suggestions for every topic target belonging to the specified entity. Returns a summary of how many targets were processed and how many winners changed. Requires authentication.
path Parameters
entityIdUnique identifier of the entity to recompute consensus for
Trigger consensus recomputation for an entity › Responses
Consensus recomputed successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Summary of a consensus computation run.
Approve or reject a suggestion via moderation
Allows a moderator to approve or reject a pending suggestion. Approved suggestions are merged into consensus. Rejected suggestions are marked accordingly. An optional reason can be provided. Requires authentication.
path Parameters
suggestionIdUnique identifier of the suggestion to moderate
Approve or reject a suggestion via moderation › Request Body
actionModeration action to take
reasonOptional reason for the moderation decision
Approve or reject a suggestion via moderation › Responses
Suggestion moderated successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Result of a moderation action on a suggestion.
List suggestions pending moderation
Returns a paginated list of consensus items that have pending suggestions awaiting moderator review. Each item includes the current consensus and a count of alternative suggestions. Requires authentication.
query Parameters
limitMaximum number of items to return per page
nextTokenOpaque cursor from a previous response for pagination
List suggestions pending moderation › Responses
Moderation queue retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Paginated moderation queue response.
Get consensus page data for SSR rendering
Returns the full consensus page for an entity, including the entity metadata, layout templates, and all computed consensus values. Used by the Next.js SSR layer to render public content pages. No authentication required.
path Parameters
entityIdUnique identifier of the entity
Get consensus page data for SSR rendering › Responses
Consensus page data retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Full consensus page payload for SSR rendering. Contains entity metadata, layout configuration, and all computed consensus values.
Resolve a full page by slug path
Single-call page resolver for public SSR. Resolves an entity by its full slug path and returns entity metadata, layout, consensus values, and breadcrumb navigation. The slugPath parameter captures the full remaining path (e.g., "dnd/classes/bard/college-of-lore"). No authentication required.
path Parameters
slugPathFull slug path to resolve. Captures multiple path segments (e.g., "dnd/classes/bard/college-of-lore").
Resolve a full page by slug path › Responses
Page resolved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Extended consensus page data returned by the slug resolver. Includes breadcrumb navigation in addition to entity, layout, and consensus data.