# UserAnnouncementDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Data transfer object for a user's view of an announcement,
including their personal interaction state.

## Fields
- `id` (string(uuid)): The announcement ID.
- `title` (string): The announcement title. (nullable)
- `body` (string): The announcement body content (Markdown). (nullable)
- `priority` ([AnnouncementPriority](https://devportal.demo.winkpg.io/docs/api/models/AnnouncementPriority.md)): The priority level.
  Values:
  - `Normal`: Normal priority. Standard styling in the notification dropdown.
  - `Important`: Important priority. Highlighted styling (e.g., orange badge).
  - `Critical`: Critical priority. Emphasized styling (e.g., red badge). When combined with PopupOnLogin display option, shows as a blocking modal.
- `displayOptions` ([AnnouncementDisplayOptions](https://devportal.demo.winkpg.io/docs/api/models/AnnouncementDisplayOptions.md)): How the announcement should be displayed.
  Values:
  - `DropdownOnly`: Announcement appears only in the notification dropdown in the header toolbar.
  - `PopupOnLogin`: Announcement appears as a popup modal on user login/page load. The popup is shown once and tracked via UserAnnouncementState.PopupShownAt.
  - `Both`: Announcement appears in both the dropdown and as a popup on login.
- `externalLinkUrl` (string): Optional external link URL. (nullable)
- `externalLinkText` (string): Optional external link display text. (nullable)
- `creationTime` (string(date-time)): When the announcement was created.
- `isRead` (boolean): Whether the user has read this announcement.
- `isDismissed` (boolean): Whether the user has dismissed this announcement.
- `popupShown` (boolean): Whether the popup has been shown for this announcement.
- `readAt` (string(date-time)): When the user read this announcement. (nullable)
- `dismissedAt` (string(date-time)): When the user dismissed this announcement. (nullable)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.