Knowledge
Remove a file
const url = 'https://app.whatsetter.com/api/v1/knowledge-bases/example/files/example';const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”Removed
Missing, unknown or revoked API key
object
object
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)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Resource not found in this workspace
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}The file is still being read
object
object
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.
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}