Dify Octri Demo
DELETE/datasets/{dataset_id}

Delete Knowledge Base

Permanently deletes a knowledge base, all of its documents, and any API key scoped only to it. Keys that also cover other knowledge bases keep working for those.

1 parameter
dataset_idstringrequired
Knowledge base ID, from [List Knowledge Bases](/en/api-reference/knowledge-bases/list-knowledge-bases). For a scoped key, [copy the ID from the Dify URL](/en/api-reference/guides/knowledge#knowledge-base-id).

3 status codes
204Knowledge base deleted successfully.
403- `forbidden` : API access is not enabled for this knowledge base. - `forbidden` : Your subscription's knowledge base request rate limit has been reached. - `forbidden` : The API key is scoped to specific knowledge bases, and this knowledge base is not one of them.

One documented failure

  • forbidden

    Dataset api access is not enabled.

    forbidden (api access)

404`not_found` : No knowledge base matches `dataset_id`.

One documented failure

  • not_found

    Dataset not found.

    not_found

Error handling

A 403 is returned: - forbidden : API access is not enabled for this knowledge base.

  • forbidden : Your subscription's knowledge base request rate limit has been reached.
  • forbidden : The API key is scoped to specific knowledge bases, and this knowledge base is not one of them. A 404 is returned: not_found : No knowledge base matches dataset_id.