Enable a knowledge base
Enable a knowledge base so its agents can retrieve from it. Idempotent.
POST
https://api.centerfy.ai/webhooks/inbound/knowledge-bases/:id/enable Headers
| Header | Required | Value | Description |
|---|---|---|---|
x-api-key | Yes | your sub-account API key (cfy_…) | Authenticates the request; or Authorization: Bearer <key>. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | The knowledge base id. |
Example
curl -X POST "https://api.centerfy.ai/webhooks/inbound/knowledge-bases/{id}/enable" \
-H "x-api-key: $CENTERFY_API_KEY" import { CenterfyClient } from "@centerfy/sdk";
const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });
const result = await centerfy.knowledgeBases.enable("<knowledgeBaseId>");
console.log(result); centerfy knowledgeBases enable <knowledgeBaseId> MCP tool: centerfy_knowledge_bases_enable (see MCP server)
Response
{
"status": "success",
"knowledge_base_id": "66666666-7777-8888-9999-000000000000",
"is_enabled": true
}Errors
400— if the id is invalid.404— if the knowledge base does not exist.200— on success.
Notes
No request body required despite POST. Idempotent (enabling an already-enabled knowledge base still succeeds).