Delete Uploaded File

Deletes an uploaded file and all associated data from the knowledge base by its unique ID. 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": "550e8400-e29b-41d4-a716-446655440000",
    "fileName": "document.pdf",
    "deletedFromAgents": true,
    "vectorsDeleted": true,
    "s3FileDeleted": true
  }
}

For the complete error reference, see Error Guide.

Authorizations

apikey · string · header · required

API Key (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