Update the individual Announcement details
put /api/v1/mdm/announcements/{announcement_id}
https://{server-hostname}:8383/api/v1/mdm/announcements/{announcement_id}
MDMDeviceMgmt.UPDATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the announcement. Obtain from the Create Announcement or Get Announcements response
Name/title of the announcement. Must be unique within the customer
Display format for the announcement (e.g., 1)
Nested object containing message details including title, content, icon, and acknowledgement settings
Title of the announcement displayed on the device
Hex color code for the title (e.g., #ffffff)
Path to the notification bar icon image (e.g., /images/announcement/nbaricon/info.png)
Short message shown in the device notification bar
Full HTML message content displayed in the app
Whether the device user must acknowledge the announcement
Button text for acknowledgement (e.g., Got It). Required when needs_acknowledgement is true
curl --request PUT \
--url https://appdomain/api/v1/mdm/announcements/{announcement_id} \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"announcement_name":"Updated Test Announcement","announcement_format":1,"announcement_detail":{"ack_button":"Got It","nbar_message":"Updated notification","title_color":"#ffffff","nbar_icon":"/images/announcement/nbaricon/info.png","needs_acknowledgement":true,"detail_message":"<p>Updated announcement content</p>","title":"Updated Test Announcement"}}'Update announcement content. Full replacement — all required fields must be provided. Updated content is auto-redistributed
{
"announcement_name": "Updated Test Announcement",
"announcement_format": 1,
"announcement_detail": {
"ack_button": "Got It",
"nbar_message": "Updated notification",
"title_color": "#ffffff",
"nbar_icon": "/images/announcement/nbaricon/info.png",
"needs_acknowledgement": true,
"detail_message": "<p>Updated announcement content</p>",
"title": "Updated Test Announcement"
}
}
204 No Content![]()
Duration: 1 minute | Threshold: 60 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.