Returns the summary overview of the specified announcement collection, including the message text, deployment status, target count, and schedule window.
get /dcapi/tools/announcement/{collectionId}/details
https://{serverurl}/dcapi/tools/announcement/{collectionId}/details
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique identifier of the system tools collection
curl --request GET \
--url https://appdomains/dcapi/tools/announcement/{collectionId}/details \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Announcement collection unique identifier
Announcement display label
Deployment status: Active, Suspended, Completed
Number of target computers or users
Scheduled start time (epoch)
Scheduled end time (epoch)
Truncated announcement message preview
{
"messageSummary": "System maintenance scheduled tonight.",
"startTime": 1711400000000,
"label": "Maintenance Window Notice",
"endTime": 1711436000000,
"collectionId": 7,
"targetCount": 40,
"status": "Active"
}
![]()
Duration: 1 minute | Threshold: 30 | 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.