Delete Uploaded File

Deletes an uploaded file and all associated data from the knowledge base by its unique ID. Use this endpoint to permanently remove a file that was uploaded via the Initiate File Uploads endpoint.

Cleanup: Removes the file, associated embeddings, and any agent references to this file.

DELETE /ai-agents/agent-builder/knowledge-base/uploads/{uniqueId}

Delete Uploaded File

cURL

curl --request DELETE \
  --url https://{appid}.api-{region}.cometchat.io/v3/ai-agents/agent-builder/knowledge-base/uploads/{uniqueId} \
  --header 'apikey: <api-key>'

200

{
  "success": true,
  "message": "File and all associated data deleted successfully",
  "data": {
    "uploadId": "<string>",
    "fileName": "<string>",
    "deletedFromAgents": true,
    "vectorsDeleted": true
  }
}

Authorizations

apikey · string · header · required

API Key with fullAccess scope(i.e. Rest API Key from the Dashboard).

Path Parameters

uniqueId · string · required

Unique upload ID to delete

Response

200

application/json

Uploaded file deleted successfully

success · boolean

Example:

true

message · string

Example:

"File and all associated data deleted successfully"

data · object

Show child attributes