# List Articles

GET /api/v2/projects/{projectId}/knowledge/articles

Lists a project's articles for management views, covering drafts and internal articles that never appear in public search. Paginated, returning `data` alongside a `total` for the filter you applied.

## Request

- projectId: string, path, required — ID of the project to list articles from.
- collectionId: string, query — Only return articles in this collection.
- helpCenterId: string, query — Only return articles belonging to this help center.
- orderBy: string, query — Article field to sort by, e.g. `createdAt` or `title`.
- orderDirection: asc | desc, query — Sort direction.
- skip: number, query — Number of articles to skip before collecting results.
- state: draft | published, query — Only return articles in this publication state.
- take: number, query — Maximum number of articles to return.
- type: public | internal, query — Only return articles for this audience: `public` for help-center content, `internal` for articles used solely to answer support questions.

## Response

- 200: Successful response
  - data: object[], required
    - authorId: string, required
    - createdAt: string, required
    - id: string, required
    - order: integer, required
    - projectId: string, required
    - slug: string, required
    - state: draft | published, required, default draft
    - title: string, required
    - type: public | internal, required, default public
    - updatedAt: string, required
    - views: integer, required
    - author: object
    - collection: object
    - collectionId: string
  - total: number, required
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 404: Not found
- 500: Internal server error