List Help Center Articles
list_articlesRead-onlyIdempotent
Retrieve a paginated list of article metadata from Zendesk Help Center. Filter by section, locale, and sort by title, creation, or update date. Include translation availability per article.
Instructions
List articles (metadata only, no body). Use get_article for full content. Optionally filter by section ID and locale. Supports sort_by ("title", "created_at", "updated_at") and include_translations: true to show available translation locales per article. Note: include_translations must be re-sent on each paginated request.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Pagination cursor from a previous response; omit for the first page. | |
| locale | No | Restrict to a single locale, e.g. "en-us" or "fr". Omit for the default locale. | |
| sort_by | No | Field to sort by; "position" (the default) is the manual order set in Guide. | position |
| page_size | No | Articles per page (1-100, default 100). | |
| section_id | No | Restrict the listing to one section (numeric id from list_sections). Omit to list articles across all sections. | |
| sort_order | No | Sort direction: ascending or descending. | asc |
| include_translations | No | Include available translation locales per article (causes 1 extra API call per article) |