Skip to content

List knowledge tables ​

Returns every knowledge table in your workspace. Knowledge tables back your AI agent's retrieval — each table is a Qdrant collection under the hood.

GET/api/user/knowledge-tables
Required scope: knowledge:read
curl -X GET "https://loopx-console.test/api/user/knowledge-tables" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
<?php

use GuzzleHttp\Client;

$client = new Client();
$response = $client->request('GET', 'https://loopx-console.test/api/user/knowledge-tables', [
    'headers' => [
        'Authorization' => 'Bearer $TOKEN',
        'Accept'        => 'application/json',
    ]
]);

$data = json_decode($response->getBody(), true);
const res = await fetch('https://loopx-console.test/api/user/knowledge-tables', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer $TOKEN',
    Accept: 'application/json'
  }
});

const data = await res.json();

Example response

{
  "status": true,
  "code": 200,
  "validation": [],
  "message": "Knowledge Tables List",
  "data": [
    {
      "id": 1,
      "name": "GenuDo KB",
      "status": "trained",
      "description": "GenuDo product features, integrations, pricing details, onboarding, and policies — search only when the user asks about these and it is not already in the conversation.",
      "training_cost": 0,
      "user_id": 2,
      "created_at": "2026-06-29T10:21:01.000000Z",
      "updated_at": "2026-06-29T10:21:16.000000Z",
      "error": null,
      "training_cost_for_user": 0,
      "user_name": "Genudo",
      "user_email": "loopx.tech@gmail.com",
      "columns_count": 2,
      "pipelines": [
        {
          "id": 16,
          "name": "GenuDo Messenger",
          "pivot": {
            "knowledge_table_id": 1,
            "pipeline_id": 16
          }
        },
        {
          "id": 17,
          "name": "GenuDo WhatsApp, US",
          "pivot": {
            "knowledge_table_id": 1,
            "pipeline_id": 17
          }
        }
      ]
    }
  ]
}

Response fields ​

FieldTypeDescription
idintegerKnowledge table id. Use in List columns and List points.
namestringHuman-readable label
statusstringtrained, training, failed — reflects the last vector-indexing run
descriptionstringFree-form text
training_costnumberTotal cost of index training in your workspace's billing units
errorstring | nullError message if the last training run failed
columns_countintegerNumber of columns defined on this table
pipelinesarrayPipelines this table is attached to (id + name)
created_at / updated_attimestampISO 8601