> For the complete documentation index, see [llms.txt](https://api-docs.myhappyforce.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.myhappyforce.com/docs/api-reference/announcement-sections.md).

# Announcement Sections

## GET /api/v1/employee/announcements/{employeeId}/sections

> Returns a list of sections of announcements container&#x20;

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"AnnouncementSectionDTO":{"type":"object","description":"Announcement section: id, title, layout, representation, listing type, search, and HTML content.","properties":{"id":{"type":"string","description":"Section identifier"},"title":{"type":"string","description":"Section title"},"layout":{"type":"string","description":"Banner layout type","enum":["HORIZONTAL","VERTICAL","HTML"]},"representation":{"type":"string","description":"Representation type","enum":["COVER","STANDARD"]},"listingType":{"type":"string","description":"Listing type","enum":["STANDARD","DATE_GROUPS","DIRECT"]},"searchEnabled":{"type":"boolean","description":"Whether search is enabled for this section"},"htmlContent":{"type":"string","description":"HTML content of the section"}}}}},"paths":{"/api/v1/employee/announcements/{employeeId}/sections":{"get":{"tags":["Announcement Sections"],"description":"Returns a list of sections of announcements container ","operationId":"getAnnouncementsSections","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AnnouncementSectionDTO"}}}}}}}}}}
```

## GET /api/v1/employee/announcements/{employeeId}/sections/{sectionId}

> Returns the configuration of a given section

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"AnnouncementSectionDTO":{"type":"object","description":"Announcement section: id, title, layout, representation, listing type, search, and HTML content.","properties":{"id":{"type":"string","description":"Section identifier"},"title":{"type":"string","description":"Section title"},"layout":{"type":"string","description":"Banner layout type","enum":["HORIZONTAL","VERTICAL","HTML"]},"representation":{"type":"string","description":"Representation type","enum":["COVER","STANDARD"]},"listingType":{"type":"string","description":"Listing type","enum":["STANDARD","DATE_GROUPS","DIRECT"]},"searchEnabled":{"type":"boolean","description":"Whether search is enabled for this section"},"htmlContent":{"type":"string","description":"HTML content of the section"}}}}},"paths":{"/api/v1/employee/announcements/{employeeId}/sections/{sectionId}":{"get":{"tags":["Announcement Sections"],"description":"Returns the configuration of a given section","operationId":"getAnnouncementsSectionById","parameters":[{"name":"sectionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnouncementSectionDTO"}}}}}}}}}
```
