List Articles Post

POST

Lists a collection of articles.

Request

This endpoint expects an object.
applies_to_partslist of stringsOptional

Filters for articles belonging to any of the provided parts.

article_typelist of "article" or "content_block"Optional
Allowed values: articlecontent_block

Filter for the type of articles. If this is not provided, then articles that are not content blocks are returned.

authored_bylist of stringsOptional

Filters for articles authored by any of the provided users.

created_bylist of stringsOptional

Filters for articles created by any of the provided users.

cursorstringOptional

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

limitintegerOptional

The maximum number of articles to return. The default is ‘50’.

mode"after" or "before"Optional
Allowed values: afterbefore

The iteration mode to use. If “after”, then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If “before”, then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.

modified_bylist of stringsOptional

Filters for articles modified by any of the provided users.

owned_bylist of stringsOptional

Filters for articles owned by any of the provided users.

scopelist of longsOptional

Filter for the scope of the articles. If this is not provided, then only external articles are returned.

shared_withlist of objectsOptional

Filter for articles based on intended audience.

Response

This endpoint returns an object.
articleslist of objects

The article entries matching the request.

totalinteger

Total number of article items for the request.

next_cursorstringOptional

The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.

prev_cursorstringOptional

The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.