# GET `/api/v1/articles`

> Part of the `Buuk Public API` API reference.

**List articles**

Lists help-center articles of the authenticated workspace, most recently updated first. Scope: help_center:read (any token role).

Base URL: `https://app.getbuuk.com`

## Authentication

Authentication:
  - `apiToken` — HTTP BEARER

## Parameters

- `status` — string (query, optional) — Filter by publication status; `all` disables filtering.
- `kind` — string (query, optional) — Filter by content kind.
- `limit` — integer (query, optional)
- `offset` — integer (query, optional)
- `Buuk-Version` — string (header, optional) — API version to use. Omit for the current version (1). Unsupported values return 400 unsupported_api_version.

## Responses

### 200 — Paged article list.

- `count` — integer
- `limit` — integer
- `offset` — integer
- `articles` — array<object>
  - `id` — string·uuid
  - `url` — string — Help-center path of the article, e.g. /help/{workspace}/{slug}.
  - `kind` — string — enum: "help" | "guide" | "faq"
  - `slug` — string
  - `title` — string
  - `status` — string — enum: "draft" | "published" | "archived"
  - `section` — string
  - `updatedAt` — string·date-time
  - `visibility` — string — enum: "everywhere" | "unlisted" | "hidden" | "ai_only"
  - `publishedAt` — string·date-time

### 401 — Missing or invalid token.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 403 — Token lacks help_center:read.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 429 — Rate limit exceeded. Retry-After header carries the wait in seconds.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

---

View in browser: /help/buuk/reference/ffbf2362-efc7-4875-bbdd-6958cc5dba67
Generated from the `Buuk Public API` reference for `buuk`.