> ## Documentation Index > Fetch the complete documentation index at: https://docs.theymes.com/llms.txt > Use this file to discover all available pages before exploring further. # Put announcements > Create or fully replace one announcement. gameId is required: null selects shared scope, a game UUID selects game scope. shortContent is localized plain text and must be nonblank in the primary language configured in your account. longContent is localized Markdown; null or an empty object clears details and is returned as an empty object. Both localization maps are replaced, removing omitted translations. Changes use the existing announcement display and inheritance behavior. ## OpenAPI ````yaml https://api.theymes.com/openapi put /announcements openapi: 3.1.0 info: title: Theymes API version: 1.0.0 description: >- Theymes API allows you to interact with the Theymes platform. Most endpoints require an API key for authentication. You can generate an API key in the Theymes dashboard. The API key should be included in the Authorization header (```Authorization: Bearer ```). The public support link endpoints do not require authentication and are grouped separately below. servers: [] security: [] tags: - name: Authenticated endpoints (API key) description: Endpoints that require an API key in the Authorization header. - name: Public support links (no authentication) description: >- Endpoints for creating web support sessions and links. These require no authentication and are identified by a game environment token. paths: /announcements: put: tags: - Authenticated endpoints (API key) description: >- Create or fully replace one announcement. gameId is required: null selects shared scope, a game UUID selects game scope. shortContent is localized plain text and must be nonblank in the primary language configured in your account. longContent is localized Markdown; null or an empty object clears details and is returned as an empty object. Both localization maps are replaced, removing omitted translations. Changes use the existing announcement display and inheritance behavior. operationId: setAnnouncement parameters: - schema: type: string description: Bearer token API key required: true description: Bearer token API key name: Authorization in: header requestBody: required: true content: application/json: schema: type: object properties: shortContent: type: object properties: en: type: string nullable: true de: type: string nullable: true es: type: string nullable: true es-AR: type: string nullable: true es-MX: type: string nullable: true fi: type: string nullable: true fil: type: string nullable: true fr: type: string nullable: true id: type: string nullable: true ja: type: string nullable: true ko: type: string nullable: true ms: type: string nullable: true pt: type: string nullable: true pt-BR: type: string nullable: true ru: type: string nullable: true tr: type: string nullable: true uk: type: string nullable: true vi: type: string nullable: true zh: type: string nullable: true zh-Hans: type: string nullable: true zh-Hant: type: string nullable: true ar: type: string nullable: true cs: type: string nullable: true da: type: string nullable: true nl: type: string nullable: true el: type: string nullable: true hu: type: string nullable: true it: type: string nullable: true 'no': type: string nullable: true nb: type: string nullable: true pl: type: string nullable: true ro: type: string nullable: true sk: type: string nullable: true sv: type: string nullable: true th: type: string nullable: true longContent: type: object nullable: true properties: en: type: string nullable: true de: type: string nullable: true es: type: string nullable: true es-AR: type: string nullable: true es-MX: type: string nullable: true fi: type: string nullable: true fil: type: string nullable: true fr: type: string nullable: true id: type: string nullable: true ja: type: string nullable: true ko: type: string nullable: true ms: type: string nullable: true pt: type: string nullable: true pt-BR: type: string nullable: true ru: type: string nullable: true tr: type: string nullable: true uk: type: string nullable: true vi: type: string nullable: true zh: type: string nullable: true zh-Hans: type: string nullable: true zh-Hant: type: string nullable: true ar: type: string nullable: true cs: type: string nullable: true da: type: string nullable: true nl: type: string nullable: true el: type: string nullable: true hu: type: string nullable: true it: type: string nullable: true 'no': type: string nullable: true nb: type: string nullable: true pl: type: string nullable: true ro: type: string nullable: true sk: type: string nullable: true sv: type: string nullable: true th: type: string nullable: true gameId: type: string nullable: true format: uuid required: - shortContent - longContent - gameId responses: '200': description: The saved announcement content: application/json: schema: type: object properties: announcement: type: object properties: shortContent: type: object properties: en: type: string nullable: true de: type: string nullable: true es: type: string nullable: true es-AR: type: string nullable: true es-MX: type: string nullable: true fi: type: string nullable: true fil: type: string nullable: true fr: type: string nullable: true id: type: string nullable: true ja: type: string nullable: true ko: type: string nullable: true ms: type: string nullable: true pt: type: string nullable: true pt-BR: type: string nullable: true ru: type: string nullable: true tr: type: string nullable: true uk: type: string nullable: true vi: type: string nullable: true zh: type: string nullable: true zh-Hans: type: string nullable: true zh-Hant: type: string nullable: true ar: type: string nullable: true cs: type: string nullable: true da: type: string nullable: true nl: type: string nullable: true el: type: string nullable: true hu: type: string nullable: true it: type: string nullable: true 'no': type: string nullable: true nb: type: string nullable: true pl: type: string nullable: true ro: type: string nullable: true sk: type: string nullable: true sv: type: string nullable: true th: type: string nullable: true longContent: type: object properties: en: type: string nullable: true de: type: string nullable: true es: type: string nullable: true es-AR: type: string nullable: true es-MX: type: string nullable: true fi: type: string nullable: true fil: type: string nullable: true fr: type: string nullable: true id: type: string nullable: true ja: type: string nullable: true ko: type: string nullable: true ms: type: string nullable: true pt: type: string nullable: true pt-BR: type: string nullable: true ru: type: string nullable: true tr: type: string nullable: true uk: type: string nullable: true vi: type: string nullable: true zh: type: string nullable: true zh-Hans: type: string nullable: true zh-Hant: type: string nullable: true ar: type: string nullable: true cs: type: string nullable: true da: type: string nullable: true nl: type: string nullable: true el: type: string nullable: true hu: type: string nullable: true it: type: string nullable: true 'no': type: string nullable: true nb: type: string nullable: true pl: type: string nullable: true ro: type: string nullable: true sk: type: string nullable: true sv: type: string nullable: true th: type: string nullable: true gameId: type: string nullable: true format: uuid required: - shortContent - longContent - gameId required: - announcement '400': description: Invalid input or missing primary-language short content '403': description: API key authentication required '404': description: Game not found ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.