---
title: "Create Pillar"
method: POST
path: "/api/v1/knowledge-base/pillars"
tags: ["Knowledge Base"]
---

# Create Pillar

`POST /api/v1/knowledge-base/pillars`

Creates a Knowledge Base pillar (a subject area that groups brand facts) from a name and optional description. Get-or-create semantics: if a pillar with the same name already exists (case-insensitive), it is returned with `created: false` instead of failing, so retries and re-imports are idempotent. Requires a website-admin API key. Also available as the MCP tool `create_pillar`.

## Request body

- object
  - `website_id` string, uuid, required — The website to create the pillar on.
  - `name` string, required — Pillar name.
  - `description` string — What the pillar covers.

## Response `201`

The created (or pre-existing) pillar

- object
  - `pillar` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `status` 'researching' | 'published' | 'draft' | 'archived', required
  - `created` boolean, required — False when a pillar with the same name already existed and was returned instead.

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - No admin access to this website, or the Knowledge Base is not enabled for the organization

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)