---
title: Promote Articles in a Section
framework: applenewsapi
role: symbol
role_heading: Web Service Endpoint
path: applenewsapi/post-sections-_sectionid_-promotedarticles
---

# Promote Articles in a Section

Set the list of promoted articles for the specified section.

## URL

POST https://news-api.apple.com/sections/{sectionId}/promotedArticles

## Path Parameters

sectionId: The UUID of the section.

## Response Codes

200 OK: The request was successful. 400 Bad Request: The specified article ID isn’t a valid UUID. Key path: data.promotedArticle. 401 Unauthorized: You didn’t include the Authorization header. Key path: None. 403 Forbidden: The channel doesn’t have permission to promote the article. Key path: data.promotedArticle. Value: Invalid ID. 404 Not Found:  The endpoint you tried to access doesn’t exist. Key path: None. NOT_FOUND. The specified section ID  doesn’t exist. Key path: None. Value: None. NOT_FOUND. The article with the specified ID doesn’t exist. Key path: data.promotedArticle. Value: Article ID. 422 : MISSING_THUMBNAIL_FOR_PROMOTED_ARTICLE. The list of articles you promoted has at least one article without a thumbnail image. Key path: data.promotedArticles.

## Discussion

Discussion A Promote Articles in a Section request sets the list of promoted articles for the specified section. You can promote up to six articles per section. Note that each article promoted in a section should have a thumbnail image. The system generates an error if an article in the list doesn’t include a thumbnail image. The list of articles given in the body of this request replaces any previous list of promoted articles. You can remove the list of promoted articles for the section by specifying an empty list. The promoted articles list is valid for a system-defined time period after it is set. The request body must be in JSON, in the following format: {   "data": {     "promotedArticles": [       "F59D1784-CAFC-432A-9A1A-EF2FCE1E1C60",       "2027DD1B-2794-4B0A-B9DC-F7EE696411FF"     ]   } } Example

## HTTP Body

The list of IDs for articles you want to promote.

## See Also

### Sections

- [List All Sections](applenewsapi/get-channels-_channelid_-sections.md)
- [Read Section Information](applenewsapi/get-sections-_sectionid_.md)
- [Section](applenewsapi/section.md)
- [SectionLinks](applenewsapi/sectionlinks.md)
- [SectionResponse](applenewsapi/sectionresponse.md)
- [PromoteArticleRequest](applenewsapi/promotearticlerequest.md)
- [PromoteArticleResponse](applenewsapi/promotearticleresponse.md)