Problem

Currently, there is no officially supported method to update the announcement banner for Jira Service Management portals programmatically via the REST API. Attempts to use the endpoint /rest/servicedesk/1/servicedesk-data/announcement/portal/{portalId} result in a 400 error (sd.portal.announcement.update.bad.request) when called with a service account, even if the account has full JSM license and administrator permissions. This limitation prevents automation and integration scenarios where organizations need to update portal announcements dynamically (e.g., for incident communications or scheduled maintenance).

Suggested Solution

Provide a documented and supported REST API endpoint that allows authorized users (including service accounts and API tokens) to programmatically update the announcement banner for specific JSM portals. The API should support both header and message fields, and enforce appropriate permission checks.

Why This Is Important

• Many organizations rely on automation to keep their service desk users informed about incidents, maintenance, or important updates.

• Manual updates via the UI are not scalable for large teams or for organizations with strict change management and automation requirements.

• Customers expect parity between UI and API capabilities for administrative tasks.

Workaround

Currently, there is no supported workaround. Manual updates must be performed via the JSM portal UI. Attempts to use undocumented endpoints are unreliable and may stop working without notice.