Adding announcement banner via API on customer portal in JSM Cloud

Jakub Nowicki

Hello dear Atlassian Community!

I'm trying to set announcement banner via REST API on customer portal. 

 

Unfortunately, I couldn't find any official Atlassian documentation. From what I've managed to determine, we can retrieve information about it, but I'm unable to update it.

GET:
https://{sitename}.atlassian.net/rest/servicedesk/1/servicedesk-data/announcement/portal/{portalID}
Returns:

{ "header": "", "headerWiki": "", "message": "", "messageWiki": "", "canEditAnnouncement": true, "canAdministerProject": true, "portalId": {portalID}, "portalProjectKey": "", "translations": { "en-US": { "header": "", "message": "" } }, "defaultLanguageTag": "en-US" }

POST:
https://{sitename}.atlassian.net/rest/servicedesk/1/servicedesk-data/announcement/portal/{portalID}

json data:

 

{ "header": "Test", "message": "test2" }

Returns:

{ "errors": [ { "errorMessage": "sd.portal.announcement.update.bad.request" } ], "reasonKey": "sd.portal.announcement.update.bad.request", "reasonCode": "400" }

Do you know if that's possible to do so?

Kai Becker

Hi @Jakub Nowicki 

it is possible to update the banner via rest api. 
@Marc -Devoteam- is right, that there is no documented endpoint, but nevertheless it is possible. You were almost there. The missing part with your JSON is the outer part.

The message and title need to have a relation to the language of the portal. For example for my project I need to set the translation to EN:

{
"translations":
{
  "en-US":
    {
      "header": "Test",
      "message": "test2"
    }
  }
}