# buuk Help Center
> This file lists all publicly available help center articles for use by AI agents and language models.
> Source: https://buuk.docs.getbuuk.com/help/buuk

# When to use this site

Use this help center to answer questions about how Buuk works — setup, tasks, API
usage and troubleshooting for the product it documents.

Site topic: Guides for writing, publishing, and keeping your help center current.

How to consume it:
- Start from /llms.txt — this index lists every published page.
- Any page URL + /content.md returns that page as Markdown (same URL as the browser page).
- Search published content at /api/help/buuk/search?q=%3Cterms%3E (rate-limited, anonymous).
- Machine-readable OpenAPI description of the API running this site: /openapi.json.
- Who publishes this site: /about — and how to reach the team: /contact.

Scope: cite specific pages when answering. If an answer is not covered here, say so
instead of guessing, and link to the closest-related page from the index above.


## Getting started

- [Quickstart](https://buuk.docs.getbuuk.com/help/buuk/quickstart): https://buuk.docs.getbuuk.com/help/buuk/quickstart/content.md
- [Introduction](https://buuk.docs.getbuuk.com/help/buuk/introduction): https://buuk.docs.getbuuk.com/help/buuk/introduction/content.md
- [How Buuk works](https://buuk.docs.getbuuk.com/help/buuk/how-buuk-works): https://buuk.docs.getbuuk.com/help/buuk/how-buuk-works/content.md
- [Core concepts](https://buuk.docs.getbuuk.com/help/buuk/core-concepts): https://buuk.docs.getbuuk.com/help/buuk/core-concepts/content.md
- [How a help center is structured](https://buuk.docs.getbuuk.com/help/buuk/organize-sections-and-folders-2): https://buuk.docs.getbuuk.com/help/buuk/organize-sections-and-folders-2/content.md
- [Onboarding walkthrough](https://buuk.docs.getbuuk.com/help/buuk/onboarding-walkthrough): https://buuk.docs.getbuuk.com/help/buuk/onboarding-walkthrough/content.md

## Writing

- [Write and publish an article](https://buuk.docs.getbuuk.com/help/buuk/write-and-publish-an-article): https://buuk.docs.getbuuk.com/help/buuk/write-and-publish-an-article/content.md
- [Editor overview](https://buuk.docs.getbuuk.com/help/buuk/editor-overview): https://buuk.docs.getbuuk.com/help/buuk/editor-overview/content.md
- [Adding Screenshots to Your Buuk Pages](https://buuk.docs.getbuuk.com/help/buuk/adding-screenshots-to-your-buuk-pages): https://buuk.docs.getbuuk.com/help/buuk/adding-screenshots-to-your-buuk-pages/content.md
- [Editor blocks](https://buuk.docs.getbuuk.com/help/buuk/editor-blocks): https://buuk.docs.getbuuk.com/help/buuk/editor-blocks/content.md
- [Callouts](https://buuk.docs.getbuuk.com/help/buuk/callouts): https://buuk.docs.getbuuk.com/help/buuk/callouts/content.md
- [Steps](https://buuk.docs.getbuuk.com/help/buuk/steps): https://buuk.docs.getbuuk.com/help/buuk/steps/content.md
- [Accordions](https://buuk.docs.getbuuk.com/help/buuk/accordions): https://buuk.docs.getbuuk.com/help/buuk/accordions/content.md
- [Cards and columns](https://buuk.docs.getbuuk.com/help/buuk/cards-and-columns): https://buuk.docs.getbuuk.com/help/buuk/cards-and-columns/content.md
- [Code blocks and code tabs](https://buuk.docs.getbuuk.com/help/buuk/code-blocks-and-code-tabs): https://buuk.docs.getbuuk.com/help/buuk/code-blocks-and-code-tabs/content.md
- [Tables](https://buuk.docs.getbuuk.com/help/buuk/tables): https://buuk.docs.getbuuk.com/help/buuk/tables/content.md
- [Images and lightbox](https://buuk.docs.getbuuk.com/help/buuk/images-and-lightbox): https://buuk.docs.getbuuk.com/help/buuk/images-and-lightbox/content.md
- [Videos](https://buuk.docs.getbuuk.com/help/buuk/videos): https://buuk.docs.getbuuk.com/help/buuk/videos/content.md
- [Embeds and HTML embeds](https://buuk.docs.getbuuk.com/help/buuk/embeds): https://buuk.docs.getbuuk.com/help/buuk/embeds/content.md
- [Reusable content blocks](https://buuk.docs.getbuuk.com/help/buuk/reusable-content-blocks): https://buuk.docs.getbuuk.com/help/buuk/reusable-content-blocks/content.md
- [Media library and uploads](https://buuk.docs.getbuuk.com/help/buuk/media-library): https://buuk.docs.getbuuk.com/help/buuk/media-library/content.md
- [Images and screenshots](https://buuk.docs.getbuuk.com/help/buuk/images-and-screenshots): https://buuk.docs.getbuuk.com/help/buuk/images-and-screenshots/content.md
- [Migration overview](https://buuk.docs.getbuuk.com/help/buuk/migration-overview): https://buuk.docs.getbuuk.com/help/buuk/migration-overview/content.md
- [Import from a live docs site](https://buuk.docs.getbuuk.com/help/buuk/import-from-live-site): https://buuk.docs.getbuuk.com/help/buuk/import-from-live-site/content.md
- [Import markdown](https://buuk.docs.getbuuk.com/help/buuk/import-markdown): https://buuk.docs.getbuuk.com/help/buuk/import-markdown/content.md
- [Export your docs](https://buuk.docs.getbuuk.com/help/buuk/export-your-docs): https://buuk.docs.getbuuk.com/help/buuk/export-your-docs/content.md
- [Organize sections and folders](https://buuk.docs.getbuuk.com/help/buuk/organize-sections-and-folders): https://buuk.docs.getbuuk.com/help/buuk/organize-sections-and-folders/content.md
- [Review, versions, and scheduling](https://buuk.docs.getbuuk.com/help/buuk/review-versions-and-scheduling): https://buuk.docs.getbuuk.com/help/buuk/review-versions-and-scheduling/content.md
- [Translations](https://buuk.docs.getbuuk.com/help/buuk/translations): https://buuk.docs.getbuuk.com/help/buuk/translations/content.md
- [Import an OpenAPI spec](https://buuk.docs.getbuuk.com/help/buuk/import-openapi): https://buuk.docs.getbuuk.com/help/buuk/import-openapi/content.md
- [The Try It playground](https://buuk.docs.getbuuk.com/help/buuk/try-it-playground): https://buuk.docs.getbuuk.com/help/buuk/try-it-playground/content.md
- [Code samples and SDKs](https://buuk.docs.getbuuk.com/help/buuk/code-samples-and-sdks): https://buuk.docs.getbuuk.com/help/buuk/code-samples-and-sdks/content.md
- [Other reference types](https://buuk.docs.getbuuk.com/help/buuk/other-reference-types): https://buuk.docs.getbuuk.com/help/buuk/other-reference-types/content.md
- [API versioning & deprecation policy](https://buuk.docs.getbuuk.com/help/buuk/api-versioning-deprecation-policy): https://buuk.docs.getbuuk.com/help/buuk/api-versioning-deprecation-policy/content.md

## Help center

- [Publish your help center](https://buuk.docs.getbuuk.com/help/buuk/publish-your-help-center): https://buuk.docs.getbuuk.com/help/buuk/publish-your-help-center/content.md
- [Branding](https://buuk.docs.getbuuk.com/help/buuk/branding-and-custom-domain): https://buuk.docs.getbuuk.com/help/buuk/branding-and-custom-domain/content.md
- [Docs homepage](https://buuk.docs.getbuuk.com/help/buuk/docs-homepage): https://buuk.docs.getbuuk.com/help/buuk/docs-homepage/content.md
- [Header links and navigation](https://buuk.docs.getbuuk.com/help/buuk/header-links-and-navigation): https://buuk.docs.getbuuk.com/help/buuk/header-links-and-navigation/content.md
- [Custom domain](https://buuk.docs.getbuuk.com/help/buuk/custom-domain): https://buuk.docs.getbuuk.com/help/buuk/custom-domain/content.md
- [Custom CSS](https://buuk.docs.getbuuk.com/help/buuk/custom-css): https://buuk.docs.getbuuk.com/help/buuk/custom-css/content.md
- [Private help centre](https://buuk.docs.getbuuk.com/help/buuk/private-help-centre): https://buuk.docs.getbuuk.com/help/buuk/private-help-centre/content.md
- [Slugs and redirects](https://buuk.docs.getbuuk.com/help/buuk/slugs-and-redirects): https://buuk.docs.getbuuk.com/help/buuk/slugs-and-redirects/content.md
- [Search and Ask AI for readers](https://buuk.docs.getbuuk.com/help/buuk/search-and-ask-ai): https://buuk.docs.getbuuk.com/help/buuk/search-and-ask-ai/content.md
- [SEO metadata and social images](https://buuk.docs.getbuuk.com/help/buuk/seo-metadata-and-social-images): https://buuk.docs.getbuuk.com/help/buuk/seo-metadata-and-social-images/content.md
- [llms.txt and markdown endpoints](https://buuk.docs.getbuuk.com/help/buuk/llms-txt-and-markdown): https://buuk.docs.getbuuk.com/help/buuk/llms-txt-and-markdown/content.md
- [Sitemap and robots](https://buuk.docs.getbuuk.com/help/buuk/sitemap-and-robots): https://buuk.docs.getbuuk.com/help/buuk/sitemap-and-robots/content.md
- [Embed the help widget](https://buuk.docs.getbuuk.com/help/buuk/embed-the-help-widget): https://buuk.docs.getbuuk.com/help/buuk/embed-the-help-widget/content.md
- [Changelog](https://buuk.docs.getbuuk.com/help/buuk/changelog): https://buuk.docs.getbuuk.com/help/buuk/changelog/content.md
- [Documentation vs FAQ vs Guides vs API](https://buuk.docs.getbuuk.com/help/buuk/docs-collections): https://buuk.docs.getbuuk.com/help/buuk/docs-collections/content.md
- [Widget settings](https://buuk.docs.getbuuk.com/help/buuk/widget-settings): https://buuk.docs.getbuuk.com/help/buuk/widget-settings/content.md
- [What the widget can do](https://buuk.docs.getbuuk.com/help/buuk/widget-features): https://buuk.docs.getbuuk.com/help/buuk/widget-features/content.md
- [Widget troubleshooting](https://buuk.docs.getbuuk.com/help/buuk/widget-troubleshooting): https://buuk.docs.getbuuk.com/help/buuk/widget-troubleshooting/content.md

## Ask Buuk & insights

- [Ask Buuk](https://buuk.docs.getbuuk.com/help/buuk/ask-buuk): https://buuk.docs.getbuuk.com/help/buuk/ask-buuk/content.md
- [Getting Better Results When Searching Help Center Articles](https://buuk.docs.getbuuk.com/help/buuk/getting-better-results-when-searching-help-center-articles): https://buuk.docs.getbuuk.com/help/buuk/getting-better-results-when-searching-help-center-articles/content.md
- [Suggested updates](https://buuk.docs.getbuuk.com/help/buuk/suggested-updates): https://buuk.docs.getbuuk.com/help/buuk/suggested-updates/content.md
- [Reporting](https://buuk.docs.getbuuk.com/help/buuk/reporting-doc-health-and-freshness): https://buuk.docs.getbuuk.com/help/buuk/reporting-doc-health-and-freshness/content.md
- [Doc health and freshness](https://buuk.docs.getbuuk.com/help/buuk/doc-health-and-freshness): https://buuk.docs.getbuuk.com/help/buuk/doc-health-and-freshness/content.md
- [MCP for readers](https://buuk.docs.getbuuk.com/help/buuk/mcp-for-readers): https://buuk.docs.getbuuk.com/help/buuk/mcp-for-readers/content.md
- [MCP for authors](https://buuk.docs.getbuuk.com/help/buuk/mcp-for-authors): https://buuk.docs.getbuuk.com/help/buuk/mcp-for-authors/content.md
- [Page actions](https://buuk.docs.getbuuk.com/help/buuk/page-actions): https://buuk.docs.getbuuk.com/help/buuk/page-actions/content.md
- [AI limits and conversations](https://buuk.docs.getbuuk.com/help/buuk/ai-limits-and-conversations): https://buuk.docs.getbuuk.com/help/buuk/ai-limits-and-conversations/content.md

## Workspace

- [Creating a Workspace in Buuk](https://buuk.docs.getbuuk.com/help/buuk/creating-a-workspace-in-buuk): https://buuk.docs.getbuuk.com/help/buuk/creating-a-workspace-in-buuk/content.md
- [Members, roles, and groups](https://buuk.docs.getbuuk.com/help/buuk/members-roles-and-groups): https://buuk.docs.getbuuk.com/help/buuk/members-roles-and-groups/content.md
- [API tokens and MCP](https://buuk.docs.getbuuk.com/help/buuk/api-tokens-and-mcp): https://buuk.docs.getbuuk.com/help/buuk/api-tokens-and-mcp/content.md
- [Webhooks](https://buuk.docs.getbuuk.com/help/buuk/webhooks): https://buuk.docs.getbuuk.com/help/buuk/webhooks/content.md
- [SSO](https://buuk.docs.getbuuk.com/help/buuk/sso): https://buuk.docs.getbuuk.com/help/buuk/sso/content.md
- [Automations](https://buuk.docs.getbuuk.com/help/buuk/automations): https://buuk.docs.getbuuk.com/help/buuk/automations/content.md
- [Account security](https://buuk.docs.getbuuk.com/help/buuk/account-security): https://buuk.docs.getbuuk.com/help/buuk/account-security/content.md
- [Notifications](https://buuk.docs.getbuuk.com/help/buuk/notifications): https://buuk.docs.getbuuk.com/help/buuk/notifications/content.md
- [Plans and billing](https://buuk.docs.getbuuk.com/help/buuk/plans-and-billing): https://buuk.docs.getbuuk.com/help/buuk/plans-and-billing/content.md
- [Trash and restoring](https://buuk.docs.getbuuk.com/help/buuk/trash-and-restore): https://buuk.docs.getbuuk.com/help/buuk/trash-and-restore/content.md
- [CLI reference](https://buuk.docs.getbuuk.com/help/buuk/cli-reference): https://buuk.docs.getbuuk.com/help/buuk/cli-reference/content.md

## Connect

- [Integrations overview](https://buuk.docs.getbuuk.com/help/buuk/connect-integrations): https://buuk.docs.getbuuk.com/help/buuk/connect-integrations/content.md
- [GitHub](https://buuk.docs.getbuuk.com/help/buuk/github): https://buuk.docs.getbuuk.com/help/buuk/github/content.md
- [Code mirrors](https://buuk.docs.getbuuk.com/help/buuk/mirror): https://buuk.docs.getbuuk.com/help/buuk/mirror/content.md
- [Confluence, Google Drive, and Databricks](https://buuk.docs.getbuuk.com/help/buuk/confluence-and-google-drive): https://buuk.docs.getbuuk.com/help/buuk/confluence-and-google-drive/content.md
- [Intercom](https://buuk.docs.getbuuk.com/help/buuk/intercom): https://buuk.docs.getbuuk.com/help/buuk/intercom/content.md
- [Zendesk](https://buuk.docs.getbuuk.com/help/buuk/zendesk): https://buuk.docs.getbuuk.com/help/buuk/zendesk/content.md
- [More support desks](https://buuk.docs.getbuuk.com/help/buuk/support-desks): https://buuk.docs.getbuuk.com/help/buuk/support-desks/content.md
- [Slack](https://buuk.docs.getbuuk.com/help/buuk/slack): https://buuk.docs.getbuuk.com/help/buuk/slack/content.md
- [Email inboxes](https://buuk.docs.getbuuk.com/help/buuk/email-inboxes): https://buuk.docs.getbuuk.com/help/buuk/email-inboxes/content.md
- [Community and social channels](https://buuk.docs.getbuuk.com/help/buuk/community-channels): https://buuk.docs.getbuuk.com/help/buuk/community-channels/content.md
- [Linear, Trello, and Featurebase](https://buuk.docs.getbuuk.com/help/buuk/product-sources): https://buuk.docs.getbuuk.com/help/buuk/product-sources/content.md
- [Rotating a Slack API Token After It's Been Exposed](https://buuk.docs.getbuuk.com/help/buuk/rotating-a-slack-api-token-after-its-been-exposed): https://buuk.docs.getbuuk.com/help/buuk/rotating-a-slack-api-token-after-its-been-exposed/content.md

# Sections

- [Getting started](https://buuk.docs.getbuuk.com/help/buuk/llms/getting-started.txt)
- [Writing](https://buuk.docs.getbuuk.com/help/buuk/llms/writing.txt)
- [Help center](https://buuk.docs.getbuuk.com/help/buuk/llms/help-center.txt)
- [Ask Buuk & insights](https://buuk.docs.getbuuk.com/help/buuk/llms/ask-buuk-insights.txt)
- [Workspace](https://buuk.docs.getbuuk.com/help/buuk/llms/workspace.txt)
- [Connect](https://buuk.docs.getbuuk.com/help/buuk/llms/connect.txt)

# API Reference

## Buuk Public API v1.0.0

> Programmatically manage the help center you are reading this on: list and edit articles and their translations and revisions, read reader feedback and AI-answer analytics, and connect an MCP client. Tokens are scoped by role: viewer tokens get the help_center:read scope, editor and owner tokens add help_center:write.

## Versioning & deprecation

- **Current version: 1.** Versions are selected with the optional `Buuk-Version` request header (omit it to get the current version); every response echoes the version that served it. Unsupported versions are rejected with `400 unsupported_api_version`. The major version is also in the URL (`/api/v1/...`); `/api/public/...` remains a supported alias for v1.
- **No breaking changes within a version.** Adding endpoints, optional parameters, response fields or enum values is not breaking; clients should ignore fields they don't recognise.
- **At least 6 months' notice** before anything is removed or changed incompatibly. Affected operations are marked `deprecated: true` in this spec, announced in the changelog, and their responses carry a `Deprecation` header (RFC 9745) and a `Sunset` header (RFC 8594) with the removal date.

> https://buuk.docs.getbuuk.com/help/buuk/reference

- [GET /api/v1/analytics/summary — Get AI answering summary](https://buuk.docs.getbuuk.com/help/buuk/reference/bdae09ac-95f7-421a-8a52-c8cac3c59102): https://buuk.docs.getbuuk.com/help/buuk/reference/bdae09ac-95f7-421a-8a52-c8cac3c59102/content.md
- [GET /api/v1/articles — List articles](https://buuk.docs.getbuuk.com/help/buuk/reference/ffbf2362-efc7-4875-bbdd-6958cc5dba67): https://buuk.docs.getbuuk.com/help/buuk/reference/ffbf2362-efc7-4875-bbdd-6958cc5dba67/content.md
- [GET /api/v1/articles/{idOrSlug} — Get one article](https://buuk.docs.getbuuk.com/help/buuk/reference/c295cb4f-b4da-45c8-a58f-cfdecfddc7b0): https://buuk.docs.getbuuk.com/help/buuk/reference/c295cb4f-b4da-45c8-a58f-cfdecfddc7b0/content.md
- [GET /api/v1/articles/{idOrSlug}/revisions — List article revisions](https://buuk.docs.getbuuk.com/help/buuk/reference/26e2fdba-8ae8-4cf5-9b52-2f9a21c284a2): https://buuk.docs.getbuuk.com/help/buuk/reference/26e2fdba-8ae8-4cf5-9b52-2f9a21c284a2/content.md
- [GET /api/v1/articles/{idOrSlug}/translations — List article translations](https://buuk.docs.getbuuk.com/help/buuk/reference/1f95b2f7-fca1-4b82-8fe5-c5c384b319ad): https://buuk.docs.getbuuk.com/help/buuk/reference/1f95b2f7-fca1-4b82-8fe5-c5c384b319ad/content.md
- [GET /api/v1/feedback — List reader feedback](https://buuk.docs.getbuuk.com/help/buuk/reference/d53aa94b-580c-4d39-b806-08b3068b6215): https://buuk.docs.getbuuk.com/help/buuk/reference/d53aa94b-580c-4d39-b806-08b3068b6215/content.md
- [POST /api/public/mcp/{workspaceSlug} — MCP (Model Context Protocol) endpoint](https://buuk.docs.getbuuk.com/help/buuk/reference/49cbcdf1-2822-48f5-8fb5-92be9a14855b): https://buuk.docs.getbuuk.com/help/buuk/reference/49cbcdf1-2822-48f5-8fb5-92be9a14855b/content.md
- [POST /api/v1/articles — Create an article](https://buuk.docs.getbuuk.com/help/buuk/reference/94775d99-7940-4977-b2f9-b4eacc945472): https://buuk.docs.getbuuk.com/help/buuk/reference/94775d99-7940-4977-b2f9-b4eacc945472/content.md
- [PATCH /api/v1/articles/{idOrSlug} — Update an article](https://buuk.docs.getbuuk.com/help/buuk/reference/1ab754df-6a63-44fc-a4e7-a3dbe7835bb3): https://buuk.docs.getbuuk.com/help/buuk/reference/1ab754df-6a63-44fc-a4e7-a3dbe7835bb3/content.md

Versions: 10/28/2026 · 10/28/2026 · 10/28/2026 · 10/28/2026 · 10/22/2026 · 10/14/2026