Skip to main content

List active knowledge docs

GET /api/knowledge-docs
Returns the active version of every knowledge doc in a project.

Query parameters

projectSlug
string
The project slug. Required if projectId is not provided.
projectId
string
The project UUID. Required if projectSlug is not provided.

Response

{
  "knowledgeDocs": [
    {
      "id": "uuid",
      "slug": "refund-policy",
      "title": "Refund Policy",
      "content": "Customers may request a refund...",
      "createdAt": "2026-04-01T12:00:00.000Z",
      "updatedAt": "2026-04-08T09:30:00.000Z"
    }
  ]
}

Example

curl "https://app.artanis.ai/api/knowledge-docs?projectSlug=my-project" \
  -H "x-api-key: $ARTANIS_API_KEY" \
  -H "x-org-slug: my-org"

Get a knowledge doc with version history

GET /api/knowledge-docs/{docId}
Returns a single knowledge doc and every version of it, oldest first.

Path parameters

docId
string
required
The knowledge doc UUID.

Response

{
  "id": "uuid",
  "slug": "refund-policy",
  "title": "Refund Policy",
  "versions": [
    {
      "id": "uuid",
      "content": "...",
      "isActive": false,
      "createdAt": "2026-03-01T00:00:00.000Z"
    },
    {
      "id": "uuid",
      "content": "...",
      "isActive": true,
      "createdAt": "2026-04-01T00:00:00.000Z"
    }
  ]
}