GET
/
v1
/
orchestrate
/
knowledge-bases
Fetch Knowledge-Bases
curl --request GET \
  --url http://{api_endpoint}/api/v1/v1/orchestrate/knowledge-bases \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tenant_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "prioritize_built_in_index": true,
    "representation": "auto",
    "vector_index": {
      "embeddings_model_name": "<string>",
      "chunk_size": 123,
      "chunk_overlap": 123,
      "status": "not_ready",
      "status_msg": "<string>",
      "top_k": 10
    },
    "conversational_search_tool": {
      "language": "en",
      "index_config": [
        {
          "connection_id": "<string>",
          "milvus": {
            "grpc_host": "<string>",
            "grpc_port": "<string>",
            "server_cert": "<string>",
            "database": "<string>",
            "collection": "<string>",
            "index": "<string>",
            "embedding_model_id": "<string>",
            "limit": 10,
            "filter": "<string>",
            "field_mapping": {
              "title": "<string>",
              "body": "<string>",
              "url": "<string>"
            }
          },
          "elastic_search": {
            "url": "<string>",
            "index": "<string>",
            "port": "<string>",
            "query_body": {},
            "result_filter": [
              "<any>"
            ],
            "field_mapping": {
              "title": "<string>",
              "body": "<string>",
              "url": "<string>"
            }
          },
          "custom_search": {
            "url": "<string>",
            "filter": "<string>",
            "metadata": {}
          }
        }
      ],
      "generation": {
        "model_id": "<string>",
        "prompt_instruction": "",
        "max_docs_passed_to_llm": 5,
        "generated_response_length": "Moderate",
        "display_text_no_results_found": "I searched my knowledge base, but did not find anything related to your query",
        "display_text_connectivity_issue": "I might have information related to your query to share, but am unable to connect to my knowledge base at the moment",
        "idk_message": "I'm afraid I don't understand. Please rephrase your question.",
        "enabled": true
      },
      "query_rewrite": {
        "enabled": true,
        "model_id": "<string>"
      },
      "confidence_thresholds": {
        "retrieval_confidence_threshold": "Lowest",
        "response_confidence_threshold": "Lowest"
      },
      "citations": {
        "citation_title": "How do we know?",
        "citations_shown": -1
      },
      "hap_filtering": {
        "output": {
          "enabled": false,
          "threshold": 0.5
        }
      },
      "query_source": "SessionHistory",
      "agent_query_description": "The query to search for in the knowledge base"
    }
  }
]

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

Response

Successful Response

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

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

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