Delete knowledge base entry by ID Beta

DELETE /v1/replicas/{replicaUUID}/knowledge-base/{knowledgeBaseID}
Organization service token Organization service token & User

Permanently removes a specific knowledge base entry and its associated vector database entry. Use this endpoint when you need to remove outdated or incorrect training data from your replica's knowledge base. This operation cannot be undone, and the entry will no longer be available for retrieval during conversations with your replica. In most cases, the deletion is completed immediately. However, in some scenarios, part of the deletion process may be delayed. This means that while the request has been accepted and the deletion process has started, some associated data may remain temporarily available and will be removed within 24 hours.

Headers

  • X-API-Version string

    Default value is 2025-03-25.

Path parameters

  • knowledgeBaseID number Required

    The unique identifier of the knowledge base entry

  • replicaUUID string(uuid) Required

    The replica unique identifier (UUID)

Responses

  • 200 application/json

    The knowledge base entry was deleted successfully.

    Hide response attribute Show response attribute object
    • success boolean Required

      Indicates the status of the request
  • 202 application/json

    The deletion process has been initiated. Full removal of all associated data may take up to 24 hours to complete.

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • message string Required

      The reason why the operation is accepted instead of returning an immediate success.
  • 404 application/json

    Knowledge base entry not found.

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • error string Required

      A text representation of the error

    • request_id string Required

      A unique identifier of the request, useful for reporting
DELETE /v1/replicas/{replicaUUID}/knowledge-base/{knowledgeBaseID} 
curl \
 --request DELETE 'https://api.sensay.io/v1/replicas/03db5651-cb61-4bdf-9ef0-89561f7c9c53/knowledge-base/12345' \
 --header "X-ORGANIZATION-SECRET: $API_KEY" \
 --header "X-API-Version: 2025-03-25"
Response examples (200) 
{
  "success": true
}
Response examples (202) 
{
  "success": true,
  "message": "The deletion process has been initiated. Full removal of all associated data may take up to 24 hours to complete."
}
Response examples (404) 
{
  "error": "A text representation of the error",
  "success": false,
  "request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}