Skip to content
Dashboard

Remove a file

DELETE
/knowledge-bases/{id}/files/{fileId}
curl --request DELETE \
--url https://app.whatsetter.com/api/v1/knowledge-bases/example/files/example \
--header 'Authorization: Bearer <token>'

Removes a file of any kind (text, PDF, Word): what the agents learned from it, its stored copy and its entry. The agents stop using it on their next reply. It cannot be brought back. Removing it a second time answers 404. A file that is still being read cannot be removed yet (409): wait until it is ready. Requires scope knowledge:write.

id
required
string
fileId
required
string

Removed

Missing, unknown or revoked API key

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Resource not found in this workspace

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

The file is still being read

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

A store did not answer. The message says whether the agents still use the file; sending the same request again finishes the removal.

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}