VoxLink.ai

API Reference

Get knowledgebases

Get all knowledgebases for the authenticated user

Updated 25 Jan 2026

This endpoint returns a list of all knowledgebases associated with your account. Knowledgebases are used to store documents that provide context and information to your AI assistants.

Response

dataarray

Array of knowledgebase objects

idinteger

  The unique identifier of the knowledgebase

namestring

  The name of the knowledgebase

descriptionstring

  Optional description of the knowledgebase

statusstring

  Current status: `empty`, `processing`, `active`, or `failed`

status_labelstring

  Human-readable status label

documents_countinteger

  Number of documents in this knowledgebase

assistants_countinteger

  Number of assistants using this knowledgebase

created_atstring

  ISO 8601 timestamp of creation

updated_atstring

  ISO 8601 timestamp of last update
{
  "data": [
    {
      "id": 1,
      "name": "Product Documentation",
      "description": "Technical documentation for our products",
      "status": "active",
      "status_label": "Active",
      "documents_count": 5,
      "assistants_count": 2,
      "created_at": "2025-01-05T10:30:00.000000Z",
      "updated_at": "2025-01-08T14:20:00.000000Z"
    },
    {
      "id": 2,
      "name": "FAQ Knowledge",
      "description": "Frequently asked questions and answers",
      "status": "processing",
      "status_label": "Processing",
      "documents_count": 1,
      "assistants_count": 0,
      "created_at": "2025-01-08T09:00:00.000000Z",
      "updated_at": "2025-01-08T09:05:00.000000Z"
    }
  ]
}
{
  "data": []
}

Knowledgebase Statuses

Status Description
empty Knowledgebase has no documents
processing One or more documents are being processed
active All documents are processed and ready
failed One or more documents failed to process

Related guides