Create Announcementpost https://{hostname}/api/talk/content/v1/announcementsThis operation creates an announcement. Authorization and Permissions An OpenAm token is required to make a post. The user must have content creation permission, which is granted by a Talk administrator. Body ParamsThe Create Announcement request payload.titlestringrequiredThe title of an announcement. The title cannot exceed 200 characters.contentstringrequiredThe content of the announcement in plaintext format. The content cannot exceed 5000 characters.whenstringThe date, time, and week of an announcement's planned release in a string format.readReceiptEnabledbooleanA Boolean indicator of whether or not a read receipt is enabled for an announcement. If enabled, this allows the system to track an acknowledgment from the user that they have read the announcement. Such announcements are automatically pinned and require the stickyExpiryDateTime property. Defaults to false.truetruefalsecommentEnabledbooleanA Boolean indicator of whether or not comments are enabled for this announcement. Defaults to true.falsetruefalselocationstringThe location associated with an announcement. The location cannot exceed 100 characters.prioritystringThe priority of an announcement. Valid values include URGENT and NORMAL. These values are not case sensitive.expiryDateTimedate-timeThe date and time an announcement expires. It shouild be in ISO8601 datetime format.stickyExpiryDateTimedate-timeThe date and time an announcement is no longer pinned at the top. If the readRecieptEnabled property is true, an announcement is pinned. It shouild be in ISO8601 datetime format.scheduledDateTimedate-timeThe scheduled date and time for an announcement to be released to users. It shouild be in ISO8601 datetime format.coverImageobjectThe attachment model used across different content types.coverImage objectattachmentsarray of objectsThe attachments to include with the announcement. The attachment object should be the same returned by the file upload API.attachmentsADD objectHeadersAuthorizationstringrequiredAn OpenAm token for the user.x-correlation-idstringA UUID value to track the request, used for debugging and tracing.acceptstringenumDefaults to application/jsonGenerated from available response content typesapplication/jsonapplication/problem+jsonAllowed:application/jsonapplication/problem+jsonResponses 200Successfully submitted a Create Announcement request. 400The HTTP status code 400 Bad Request error, thrown when required parameters are not passed. 401The HTTP status code 401 Unauthorized error, thrown when the user is not authorized to access the resource. 403The HTTP status code 403 Forbidden error, thrown when the user is not authorized to access the resource. 405The HTTP status code 405 Method Not Allowed error, thrown when you attempt to call a URI with an unsupported HTTP method. 406The HTTP status code 406 Not Acceptable Content error, thrown when you send a request with accept header other than application/json. 413The HTTP status code 413 Payload Too Large error, thrown when you attempt to pass a request payload that exceeds the limit. 429The HTTP status code 429 Too Many Requests error, thrown when the user exceeds the allowed rate limit for the API. 500The HTTP status code 500 Internal Server error, thrown when the server is not able to process the request.Updated 9 months ago
