API quickstart

The Buuk API lets you manage help centers, publish articles, and search documentation programmatically. This quickstart walks through creating a token and listing articles in your workspace.

Prerequisites

• A Buuk workspace with API access enabled
• cURL or your preferred HTTP client
• Workspace owner or admin role (required to mint API tokens)

1. Create an API token

1. 1

   Request a token

   Exchange your workspace credentials for a bearer token. Tokens expire after 24 hours.

   bashCopy

   curl -X POST https://api.buuk.app/v1/auth/token \
     -H "Content-Type: application/json" \
     -d '{"email":"you@company.com","password":"your-password"}'

2. 2

   Save the response

   Copy the token field from the JSON response. Treat it like a password — never commit it to git.

   jsonCopy

   {
     "token": "buuk_live_abc123",
     "expiresIn": 86400
   }

2. List articles

Pass the token in the Authorization header on every request.

curl https://api.buuk.app/v1/articles?status=published&limit=10 \
  -H "Authorization: Bearer buuk_live_abc123"

Next steps

• Read the Authentication guide for token rotation and scopes
• Explore the API Reference for Articles, Workspaces, and Search
• Set up webhooks to react to article publish events (coming soon)