Skip to main content
PUT
/
v1
/
knowledge
/
{knowledge_base_id}
curl -X PUT https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
  -H "authorization: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "name": "Updated Company FAQs"
  }'

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T",
    "name": "Updated Company FAQs",
    "description": "Updated frequently asked questions and company policies for 2025",
    "status": "COMPLETED",
    "type": "FILE",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T15:45:00Z",
    "file": {
      "file_name": "company_faqs.pdf",
      "file_size": 2048576,
      "file_type": "application/pdf"
    }
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

Updates the metadata (name and description) of an existing knowledge base. This endpoint does not modify the content of the knowledge base, only its descriptive information.

​
Headers

​
authorization
string
required
Your API key for authentication.
​
content-type
string
required
Must be application/json.

​
Path Parameters

​
knowledge_base_id
string
required
The unique identifier of the knowledge base to update.

​
Body Parameters

​
name
string
New name for the knowledge base. If not provided, the current name is retained.
​
description
string
New description for the knowledge base. Pass null to remove the description entirely.

​
Response

​
data
object
The updated knowledge base object.
​
data.id
string
Unique identifier for the knowledge base.
​
data.name
string
Updated name of the knowledge base.
​
data.description
string
Updated description of the knowledge base.
​
data.status
string
Current status: "PROCESSING", "COMPLETED", "FAILED", or "DELETED".
​
data.type
string
Type of knowledge base: "FILE", "WEB_SCRAPE", or "TEXT".
​
data.source_urls
string
Source URLs for web scrape type (comma-separated).
​
data.base_url
string
Base URL for web scrape type.
​
data.created_at
string
ISO timestamp of creation.
​
data.updated_at
string
ISO timestamp of last update.
​
data.error_message
string
Error message if status is "FAILED".
​
data.file
object
File information for file-type knowledge bases.
​
data.file.file_name
string
Original filename.
​
data.file.file_size
number
File size in bytes.
​
data.file.file_type
string
MIME type of the file.
​
errors
null
Will be null on successful update.
curl -X PUT https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
  -H "authorization: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "name": "Updated Company FAQs"
  }'

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T",
    "name": "Updated Company FAQs",
    "description": "Updated frequently asked questions and company policies for 2025",
    "status": "COMPLETED",
    "type": "FILE",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T15:45:00Z",
    "file": {
      "file_name": "company_faqs.pdf",
      "file_size": 2048576,
      "file_type": "application/pdf"
    }
  },
  "errors": null
}
Docs for agents: llms.txt