Announcements
Publish and manage announcements in the workspace feed.
5 tools
# create_announcement
Announce a document, release, milestone, or other entity to the workspace feed
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ref_type | string | ● | Type of referenced entity (document, release, milestone, etc.) |
| ref_id | string | ● | UUID of the referenced entity |
| author_email | string | — | DEPRECATED — ignored. The author is the authenticated caller; omit this field. |
| message | string | — | Optional announcement message/blurb |
| visibility_type | string | — | workspace|project|group|private (default: workspace) |
| visibility_ref | string | — | Group name for group visibility |
| project_id | string | — | Project scope for project visibility |
| pinned | boolean | — | Pin to top of feed |
# list_announcements
List announcements in the workspace feed (respects visibility)
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| user_email | string | — | Viewer email (for private visibility filtering) |
| project_id | string | — | Filter by project |
| limit | integer | — | Max results |
| offset | integer | — | Offset |
# get_announcement
Get a single announcement by ID
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| announcement_id | string | ● | Announcement ID |
# pin_announcement
Pin or unpin an announcement
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| announcement_id | string | ● | Announcement ID |
| pinned | boolean | — | Pin (true) or unpin (false) |
# delete_announcement
Delete an announcement from the feed
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| announcement_id | string | ● | Announcement ID |