Retell AI List Knowledge Bases API
The List Knowledge Bases API from Retell AI — 1 operation(s) for list knowledge bases.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/retell-ai-list-knowledge-bases-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Retell SDK Add Community Voice List Knowledge Bases API
version: 3.0.0
contact:
name: Retell Support
url: https://www.retellai.com/
email: support@retellai.com
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api.retellai.com
description: The production server.
security:
- api_key: []
tags:
- name: List Knowledge Bases
paths:
/list-knowledge-bases:
get:
description: List all knowledge bases
operationId: listKnowledgeBases
responses:
'200':
description: Successfully retrieved all knowledge bases.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/KnowledgeBaseResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
tags:
- List Knowledge Bases
components:
responses:
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: API key is missing or invalid.
InternalServerError:
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: An unexpected server error occurred.
TooManyRequests:
description: Too Many Requests
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: Account rate limited, please throttle your requests.
schemas:
KnowledgeBaseResponse:
type: object
required:
- knowledge_base_id
- knowledge_base_name
- status
properties:
knowledge_base_id:
type: string
example: knowledge_base_a456426614174000
description: Unique id of the knowledge base.
knowledge_base_name:
type: string
example: Sample KB
description: Name of the knowledge base. Must be less than 40 characters.
status:
type: string
enum:
- in_progress
- complete
- error
- refreshing_in_progress
example: in_progress
description: Status of the knowledge base. When it's created and being processed, it's "in_progress". When the processing is done, it's "complete". When there's an error in processing, it's "error". When it is during kb updating, it's "refreshing_in_progress".
max_chunk_size:
type: integer
example: 2000
description: Maximum number of characters per chunk when splitting knowledge base content.
min_chunk_size:
type: integer
example: 400
description: Minimum number of characters per chunk. Chunks smaller than this are merged with adjacent chunks.
knowledge_base_sources:
type: array
items:
oneOf:
- $ref: '#/components/schemas/KnowledgeBaseSourceDocument'
- $ref: '#/components/schemas/KnowledgeBaseSourceText'
- $ref: '#/components/schemas/KnowledgeBaseSourceUrl'
description: Sources of the knowledge base. Will be populated after the processing is done (when status is "complete").
enable_auto_refresh:
type: boolean
example: true
description: Whether to enable auto refresh for the knowledge base urls. If set to true, will retrieve the data from the specified url every 12 hours.
last_refreshed_timestamp:
type: integer
example: 1703413636133
description: Last refreshed timestamp (milliseconds since epoch). Only applicable when enable_auto_refresh is true.
KnowledgeBaseSourceUrl:
type: object
required:
- type
- source_id
- url
properties:
type:
type: string
enum:
- url
description: Type of the knowledge base source.
source_id:
type: string
description: Unique id of the knowledge base source.
url:
type: string
description: URL used to be scraped and added to the knowledge base.
KnowledgeBaseSourceText:
type: object
required:
- type
- source_id
- title
- content_url
properties:
type:
type: string
enum:
- text
description: Type of the knowledge base source.
source_id:
type: string
description: Unique id of the knowledge base source.
title:
type: string
description: Title of the text.
content_url:
type: string
description: URL of the text content stored.
KnowledgeBaseSourceDocument:
type: object
required:
- type
- source_id
- filename
- file_url
- file_size
properties:
type:
type: string
enum:
- document
description: Type of the knowledge base source.
source_id:
type: string
description: Unique id of the knowledge base source.
filename:
type: string
description: Filename of the document.
file_url:
type: string
description: URL of the document stored.
securitySchemes:
api_key:
type: http
scheme: bearer
bearerFormat: string
description: Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"