> 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/announcements-sections-resource.md).

# Announcements Sections Resource

## GET /api/v1/company/announcements/sections

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"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/company/announcements/sections":{"get":{"tags":["announcements-sections-resource"],"operationId":"getAnnouncementsSections_1","parameters":[{"name":"announcementText","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"hierarchyId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"filters","in":"query","required":false,"schema":{"type":"string"}},{"name":"groupId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"categoryId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"pinned","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"signed","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hfSigned","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"published","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"draft","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"reply","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hasReactions","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hasComments","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AnnouncementSectionDTO"}}}}}}}}}}
```

## GET /api/v1/company/announcements/sections/{sectionId}

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"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/company/announcements/sections/{sectionId}":{"get":{"tags":["announcements-sections-resource"],"operationId":"getAnnouncementSections","parameters":[{"name":"sectionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"announcementText","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"hierarchyId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"filters","in":"query","required":false,"schema":{"type":"string"}},{"name":"groupId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"categoryId","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"pinned","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"signed","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hfSigned","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"published","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"draft","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"reply","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hasReactions","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hasComments","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AnnouncementSectionDTO"}}}}}}}}}
```
