List Knowledge Bases

Lists the Knowledge Bases in one project, newest first.

GET /api/v1/knowledge-bases

Query parameters

Parameter	Type	Required	Description
`projectId`	string (UUID)	With an org-scoped key: yes	The project to list. A project-scoped key always lists its own project; naming a different one returns `403`. An org-scoped key must name a project.
`limit`	integer 1–100	No	Page size. Default `20`.
`cursor`	string	No	The `nextCursor` from the previous page.

Response

200 OK

{
  "items": [
    {
      "knowledgeBaseId": "4f1c…",
      "projectId": "2b7e…",
      "name": "Pump manuals",
      "status": "ACTIVE",
      "embeddingLlmConfigId": "8b1e…",
      "embeddingModel": "text-embedding-3-small",
      "searchMode": "hybrid",
      "documentCount": 12,
      "totalSizeBytes": 4812933,
      "createdAt": "2026-10-09T08:00:00Z"
    }
  ],
  "nextCursor": null
}

status is ACTIVE once created, INDEXING while a settings change re-indexes it, and FAILED if that failed. Only an ACTIVE Knowledge Base can be searched. Each document's own progress is in List documents.

Errors

Status	`error`	When
`400`	`project_required`	An org-scoped key did not pass `projectId`.
`403`	`forbidden`	A project-scoped key named a project other than its own.
`422`	`project_not_found`	`projectId` is not a project of your organization.
`503`	`knowledge_service_unavailable`	The Knowledge Base service is unreachable or not configured.

Example

curl "https://api.elizon.ai/api/v1/knowledge-bases?projectId=2b7e…" \
  -H "X-API-Key: elz_your_key_here"

List Knowledge Bases

Query parameters

Response

Errors

Example

On this page