---
title: "API quickstart"
url: "/help/buuk/guides/api-quickstart"
updated: "2026-11-13T13:32:08.989Z"
---
# API quickstart

The public API lets you list and update articles, read analytics, and talk to MCP with a workspace token. This quickstart mints a token and lists published articles.

> [!TIP]
> **Use a token, not a password. **Create a `buuk_cli_…` secret in Settings → Developers → API tokens. It is shown once.

## Prerequisites

- A Buuk workspace where you are an owner or editor
- cURL or your preferred HTTP client
- A write or read-only API token from Settings → Developers → API tokens

## 1. Create an API token

1. **Open API settings**
   Go to **Settings → Developers → API tokens**. Choose write access (suggest and update articles) or read only.

2. **Copy the secret**
   The token starts with `buuk_cli_`. Store it in an environment variable — never in git.
   
   ```bash
   export BUUK_API_URL=https://app.getbuuk.com
   export BUUK_API_TOKEN=buuk_cli_…
   export BUUK_WORKSPACE=buuk
   ```

## 2. List articles

Pass the token in the `Authorization` header on every request.

```bash
curl "$BUUK_API_URL/api/public/articles?status=published&limit=10" \
  -H "Authorization: Bearer $BUUK_API_TOKEN"
```

> [!NOTE]
> List endpoints use `limit` and `offset`. Increase offset by limit until the returned `count` is smaller than limit.

## Next steps

- Read the Authentication guide for scopes and revocation
- Explore the API Reference for articles, analytics, and MCP
- See API tokens and MCP in Documentation for the dashboard flow