Skip to main content
Fetch Knowledge-Bases
curl --request GET \
  --url https://{api_endpoint}/api/v1/orchestrate/knowledge-bases \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tenant_id": "<string>",
    "name": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "prioritize_built_in_index": true,
    "created_by": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "representation": "auto",
    "vector_index": {
      "embeddings_model_name": "<string>",
      "chunk_size": 123,
      "chunk_overlap": 123,
      "status": "ready",
      "status_msg": "<string>",
      "top_k": 123,
      "extraction_strategy": "express"
    },
    "conversational_search_tool": {
      "language": "<string>",
      "index_config": [
        {
          "connection_id": "<string>",
          "milvus": {},
          "elastic_search": {},
          "custom_search": {},
          "astradb": {}
        }
      ],
      "generation": {
        "model_id": "<string>",
        "prompt_instruction": "<string>",
        "max_docs_passed_to_llm": 123,
        "generated_response_length": "Concise",
        "display_text_no_results_found": "<string>",
        "display_text_connectivity_issue": "<string>",
        "idk_message": "<string>",
        "enabled": true
      },
      "query_rewrite": {
        "enabled": true,
        "model_id": "<string>"
      },
      "confidence_thresholds": {
        "retrieval_confidence_threshold": "Off",
        "response_confidence_threshold": "Off"
      },
      "citations": {
        "citation_title": "<string>",
        "citations_shown": 123
      },
      "hap_filtering": {
        "output": {
          "enabled": true,
          "threshold": 123
        }
      },
      "query_source": "SessionHistory",
      "agent_query_description": "<string>",
      "supports_full_document": true
    }
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

names
string[] | null
ids
string[] | null
query
string | null

Search by name and description

limit
integer | null

Limit the number of results returned

Required range: x >= 1
offset
integer | null
default:0

Skip the first N results

Required range: x >= 0
sort
enum<string> | null
default:asc

Sort by name and recently added (recent/asc/desc)

Available options:
asc,
desc,
recent

Response

Successful Response

  • ListKnowledgeBase · object[]
  • KnowledgeBasesResponseWithPagination · object
id
string<uuid>
required

Unique identifier for the KB

tenant_id
string
required

ID of the tenant that owns this KB

name
string
required

Name of the KB

display_name
string | null
required

Display name of the KB

description
string
required

Description of what the KB contains

prioritize_built_in_index
boolean
required

prioritize built in vector index if both a built in index and external index is provided

created_by
string
required

Username of the user who created the KB

updated_at
string<date-time>
required

Last update timestamp

representation
enum<string>
required
Available options:
auto,
tool
vector_index
object
required
conversational_search_tool
object | null
required