ATathenahq
Knowledge Base

Update Pillar

Changed on

Updates a Knowledge Base pillar's name, description, or status. At least one of the three must be provided; only provided fields change. Renaming returns a 409 when another pillar already uses the name. Status accepts published or archived: archiving hides the pillar from pillar listings and stops its facts feeding content generation, while keeping the facts stored. Requires a website-admin API key. Also available as the MCP tool update_pillar.

patch/api/v1/knowledge-base/pillars/{pillar_id}

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Path parameters

pillar_idstring uuid required

The pillar to update.

Request body

website_idstring uuid required

The website the pillar belongs to.

namestring

New pillar name.

descriptionstring

New pillar description. An empty string clears the stored description.

status'published' | 'archived'

New status. Only published and archived are accepted; the pipeline-internal states (draft, researching) cannot be set over the API.

Response

The updated pillar plus a pre-update snapshot of the editable fields

Changes