ATathenahq
Knowledge Base

Delete Pillars

Changed on

Permanently deletes 1-20 Knowledge Base pillars and every fact filed under them. Facts are deleted, not unfiled; there is no undo. Ids with no pillar on the website are reported in not_found_ids instead of failing the call, so retries are idempotent; ids in failed_ids are untouched and safe to retry. Requires a website-admin API key; on OAuth MCP connections the signed-in user must hold the admin role. Also available as the MCP tool delete_pillars.

post/api/v1/knowledge-base/pillars/delete

Request

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

Request body

website_idstring uuid required

The website whose pillars to delete.

pillar_idsstring[] required

Pillars to delete. A single delete is a one-element array.

Response

Deletion report

successtrue required
not_found_idsstring[] required

Requested ids with no pillar on this website: already deleted or never existed.

failed_idsstring[] required

Pillars whose delete errored. Each pillar deletes in its own transaction, so these are untouched and safe to retry.

Changes