v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2113138232.4 KB
recommended_articles_lists

Create or update a recommended articles list

Create a new recommended articles list or update an existing one. Requires Administrator privileges.

Body Parameter Guidelines:

  • name: Curated list title or label (e.g. "Editor's Choice").
  • placement_area: Target UI layout region (e.g. main_feed, sidebar_top, onboarding).
  • expires_at: ISO 8601 timestamp after which the list recommendation automatically expires.
  • user_id: Owner/curator numeric user ID.
  • article_ids: Staged array of numeric article IDs to include in the recommendation sequence.
post/api/recommended_articles_lists

Request body

namestring
placement_areastring required
expires_atstring date-time
user_idinteger required
article_idsinteger[]

Response

created

idinteger required
namestring required
placement_areastring required
expires_atstring date-time nullable
user_idinteger required
article_idsinteger[] required
created_atstring date-time required
updated_atstring date-time required