> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/platform/enterprise-features/workspace-announcements.md).

# Workspace Announcements

Schedule a short banner that every member of your Workspace sees in the Roboflow app.

Workspace Announcements let you post a short message to everyone in your Workspace (ex: a labeling freeze, a new review process). Members see it as a banner at the bottom of Workspace pages, with a megaphone icon that shows it comes from your organization, not Roboflow. You pick when the banner starts and stops.

{% hint style="info" %}
Workspace Announcements are available on Enterprise and the earlier Growth plan. [Contact sales](https://roboflow.com/sales) to get access.
{% endhint %}

## About

Admins can manage announcements. So can any custom role with the `manage_workspace_announcements` permission. Every member sees the banner.

These rules apply to each announcement:

* The message is plain text, up to 400 characters. Line breaks are allowed.
* Only one announcement can run at a time, so scheduled windows cannot overlap. One can end at the same moment the next one starts.
* A window runs for at least 5 minutes and at most 1 year. A start time in the past moves to now.
* The banner shows within about a minute of its start time. Members do not need to reload the page.

Members can dismiss the banner with its X button. The app remembers this per device, not per account. If you change the message or the start time, the banner shows again to everyone who dismissed it. Changing the end time or time zone does not.

The banner does not show in the annotation editor, Roboflow Universe, login pages, or embed and share pages.

Each create, edit, and delete adds an entry to your [Audit Logs](https://docs.roboflow.com/platform/enterprise-features/audit-logs-and-siem-export.md).

## Web App

1. Go to Settings, then click "Announcements".
2. Write your message. The "Live Preview" shows how the banner will look.
3. Pick a "Time Zone", a start, and an end. The page shows the start and end in your time zone and in UTC.
4. Click "Create Announcement".

The page lists your announcements under "Active", "Upcoming", and "Previous". Use the buttons in the "Actions" column to edit or delete one.

## HTTP API

Use a [Scoped API Key](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys) with the `workspace-announcement:read` scope to list announcements and `workspace-announcement:write` to change them. A plain API key acts as a Workspace owner. An OAuth token acts as its user, who needs permission to manage announcements.

### List Announcements

{% openapi src="/files/NK9f0wnAhsSG9hHYuc7p" path="/{workspace}/workspace-announcements" method="get" %}
[workspace-announcements.yaml](https://4160767428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-c8a63f50b8fd6c06b8b1855f078d73abe7fd7cee%2Fworkspace-announcements.yaml?alt=media)
{% endopenapi %}

### Create an Announcement

{% openapi src="/files/NK9f0wnAhsSG9hHYuc7p" path="/{workspace}/workspace-announcements" method="post" %}
[workspace-announcements.yaml](https://4160767428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-c8a63f50b8fd6c06b8b1855f078d73abe7fd7cee%2Fworkspace-announcements.yaml?alt=media)
{% endopenapi %}

### Update an Announcement

Check `dismissalsReset` in the response. When it is true, the banner shows again to members who dismissed it.

{% openapi src="/files/NK9f0wnAhsSG9hHYuc7p" path="/{workspace}/workspace-announcements/{announcementId}" method="patch" %}
[workspace-announcements.yaml](https://4160767428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-c8a63f50b8fd6c06b8b1855f078d73abe7fd7cee%2Fworkspace-announcements.yaml?alt=media)
{% endopenapi %}

### Delete an Announcement

{% openapi src="/files/NK9f0wnAhsSG9hHYuc7p" path="/{workspace}/workspace-announcements/{announcementId}" method="delete" %}
[workspace-announcements.yaml](https://4160767428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-c8a63f50b8fd6c06b8b1855f078d73abe7fd7cee%2Fworkspace-announcements.yaml?alt=media)
{% endopenapi %}
