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
}
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
}
⌘I