Guestbooks and polls
Guestbook messages and poll votes belong to social profile widgets.
Object schema
Fields returned by List guestbook messages. Individual endpoint pages document their complete response shapes.
| Name | Type | Required | Description |
|---|---|---|---|
threads | array<object> | Required | Threads. |
threads[].id | string | Required | Unique identifier. |
threads[].createdAt | number | Required | Creation time. |
threads[].ownerUserId | string | Required | Owner User Id. |
threads[].parentMessageId | null | string | Required | Parent Message Id. |
threads[].authorDisplayName | string | Required | Author Display Name. |
threads[].postedAnonymously | boolean | Required | Posted Anonymously. |
threads[].body | string | Required | Body. |
threads[].hiddenByOwner | boolean | Required | Hidden By Owner. |
threads[].authorUserId | null | string | Required | Author User Id. Owner can see the real author even when posted anonymously; visitors cannot. |
threads[].displayName | string | Required | Display name. Display name a visitor should see (anonymised when applicable). |
threads[].authorAvatarUrl | null | string | Required | Author Avatar Url. Author profile picture (null for anonymous viewers and missing avatars). |
threads[].authorStatus | null | object | Required | Author Status. Account-status flags rendered as badges next to the name (omitted for anonymous). |
threads[].authorStatus.isAdmin | boolean | Required | Is Admin. |
threads[].authorStatus.planKey | null | string | Required | Plan Key. |
threads[].authorStatus.donorSupporterUnlocked | boolean | Required | Donor Supporter Unlocked. |
threads[].authorStatus.closedBetaParticipantAt | null | number | Required | Closed Beta Participant At. |
threads[].authorStatus.bugBountyUnlockedAt | null | number | Required | Bug Bounty Unlocked At. |
threads[].authorProfileStyle | null | object | Required | Author Profile Style. Friend-account appearance (`app_profiles.friend_profile_style`) for name fonts + avatar ring chrome. Null when anonymised to the viewer or missing. |
threads[].authorProfileStyle.avatarRing | object | Optional | Avatar Ring. |
threads[].authorProfileStyle.bannerFrame | object | Optional | Banner Frame. |
threads[].authorProfileStyle.memberName | object | Optional | Member Name. |
threads[].authorProfileStyle.bannerImage | object | Optional | Banner Image. |
threads[].authorProfileStyle.avatarImage | object | Optional | Avatar Image. |
threads[].authorProfileStyle.bannerOverlay | string | Optional | Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid". |
threads[].authorProfileStyle.profileBackgroundPattern | string | Optional | Profile Background Pattern. Allowed values: "grid", "none", "dots", "noise". |
threads[].authorProfileStyle.heroLayout | string | Optional | Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left". |
threads[].authorProfileStyle.accentColorHex | null | string | Optional | Accent Color Hex. |
threads[].authorProfileStyle.profileBackgroundFill | object | Optional | Profile Background Fill. |
threads[].authorProfileStyle.pageBackgroundFill | object | Optional | Page Background Fill. Friend-only: full Friends viewport backdrop (solid/gradient). |
threads[].authorProfileStyle.panelBackgroundFill | object | Optional | Panel Background Fill. Friend-only: profile card panel fill (free: preset solids; Pro+: custom solid/gradient). |
threads[].authorProfileStyle.panelFillAccentHex | null | string | Optional | Panel Fill Accent Hex. Friend-only: optional accent mixed into the profile panel backdrop (Pro+). |
threads[].authorProfileStyle.panelCardAccentHex | null | string | Optional | Panel Card Accent Hex. Friend-only: optional accent mixed into section cards (Pro+). |
threads[].replies | array<object> | Required | Replies. |
threads[].replies[].id | string | Required | Unique identifier. |
threads[].replies[].createdAt | number | Required | Creation time. |
threads[].replies[].ownerUserId | string | Required | Owner User Id. |
threads[].replies[].parentMessageId | null | string | Required | Parent Message Id. |
threads[].replies[].authorDisplayName | string | Required | Author Display Name. |
threads[].replies[].postedAnonymously | boolean | Required | Posted Anonymously. |
threads[].replies[].body | string | Required | Body. |
threads[].replies[].hiddenByOwner | boolean | Required | Hidden By Owner. |
threads[].replies[].authorUserId | null | string | Required | Author User Id. Owner can see the real author even when posted anonymously; visitors cannot. |
threads[].replies[].displayName | string | Required | Display name. Display name a visitor should see (anonymised when applicable). |
threads[].replies[].authorAvatarUrl | null | string | Required | Author Avatar Url. Author profile picture (null for anonymous viewers and missing avatars). |
threads[].replies[].authorStatus | null | object | Required | Author Status. Account-status flags rendered as badges next to the name (omitted for anonymous). |
threads[].replies[].authorProfileStyle | null | object | Required | Author Profile Style. Friend-account appearance (`app_profiles.friend_profile_style`) for name fonts + avatar ring chrome. Null when anonymised to the viewer or missing. |
nextCursor | null | number | Required | Cursor for the next page; null when there are no further results. |
total | number | Required | Total. |
Endpoints
6 operations
POSTCreate guestbook block author
/api/v1/social/widgets/{widgetId}/guestbook/block-authorDELETEDelete guestbook message/api/v1/social/widgets/{widgetId}/guestbook/messages/{messageId}GETList guestbook messages/api/v1/social/widgets/{widgetId}/guestbookPOSTCreate guestbook message/api/v1/social/widgets/{widgetId}/guestbookGETGet poll state/api/v1/social/widgets/{widgetId}/pollPOSTCreate poll vote/api/v1/social/widgets/{widgetId}/poll