---
title: "List all knowledge bases"
method: GET
path: "/v2/knowledge"
tags: ["Knowledge Bases"]
---

# List all knowledge bases

`GET /v2/knowledge`

Returns a list of your knowledge bases. The knowledge bases are returned sorted by creation date, with the most recent knowledge bases appearing first

## Query parameters

- `starting_after` string — A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list.
- `ending_before` string — A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list.
- `limit` integer — A limit on the number of objects to be returned. Limit can range between 1 and 300, and the default is 25
- `search` string — Filter knowledge bases by key (case-insensitive match)
- `updated_by` string — Filter by the users who last updated the knowledge base. Accepts a comma-separated list of user IDs
- `type` 'internal' | 'external' — Filter knowledge bases by type
- `project_id` string — Filter knowledge bases by project ID

## Response `200`

Knowledge bases retrieved

- object
  - `object` 'list', required
  - `data` union[], required
    - union
      - object
        - `_id` string, required — The unique identifier of the knowledge base.
        - `created` string, required — The creation date of the knowledge base.
        - `description` string, nullable — The description of the knowledge base.
        - `key` string, required — The unique key of the knowledge base.
        - `domain_id` string, required — The project/domain ID of the knowledge base.
        - `path` string — Entity storage path. With workspace-level API keys, use the format `project/folder/subfolder/...`. The first element identifies the project, followed by nested folders (auto-created as needed). Example: `Default/agents`. With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: `agents`. For backward compatibility, a leading project name is ignored when it matches the scoped project.
        - `created_by_id` string, uuid, nullable
        - `updated_by_id` string, uuid, nullable
        - `updated` string, required — The last update date of the knowledge base.
        - `type` 'internal'
        - `retrieval_settings` object — The retrieval settings for the knowledge base. If not provider, Hybrid Search will be used as a default query strategy.
          - `retrieval_type` 'vector_search' | 'keyword_search' | 'hybrid_search' — The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
          - `top_k` integer — The number of results to return from the search.
          - `threshold` number — The threshold value used to filter the search results, only documents with a relevance score greater than the threshold will be returned
          - `rerank_config` object, nullable — The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
            - `top_k` integer — The number of results to return by the reranking model
            - `rerank_threshold` number — The threshold value used to filter the rerank results, only documents with a relevance score greater than the threshold will be returned
            - `rerank_model` string, required — The rerank model to use for the knowledge base.
          - `agentic_rag_config` object, nullable — The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
            - `model` string, required — The model to use for the Agentic RAG
        - `model` string, required — The embeddings model used for the knowledge base.
      - object
        - `_id` string, required — The unique identifier of the knowledge base.
        - `created` string, required — The creation date of the knowledge base.
        - `description` string, nullable — The description of the knowledge base.
        - `key` string, required — The unique key of the knowledge base.
        - `domain_id` string, required — The project/domain ID of the knowledge base.
        - `path` string — Entity storage path. With workspace-level API keys, use the format `project/folder/subfolder/...`. The first element identifies the project, followed by nested folders (auto-created as needed). Example: `Default/agents`. With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: `agents`. For backward compatibility, a leading project name is ignored when it matches the scoped project.
        - `created_by_id` string, uuid, nullable
        - `updated_by_id` string, uuid, nullable
        - `updated` string, required — The last update date of the knowledge base.
        - `type` 'external'
        - `retrieval_settings` object — The retrieval settings for the knowledge base.
          - `top_k` integer — The number of results to return from the search.
          - `threshold` number — The threshold value used to filter the search results, only documents with a relevance score greater than the threshold will be returned
          - `rerank_config` object, nullable — The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
            - `top_k` integer — The number of results to return by the reranking model
            - `rerank_threshold` number — The threshold value used to filter the rerank results, only documents with a relevance score greater than the threshold will be returned
            - `rerank_model` string, required — The rerank model to use for the knowledge base.
          - `agentic_rag_config` object, nullable — The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
            - `model` string, required — The model to use for the Agentic RAG
        - `external_config` object, required
          - `name` string, required — The name of the external knowledge base.
          - `api_url` string, uri, required — The API URL of the external knowledge base.
  - `has_more` boolean, required

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/6a22c53a2580/schema)