Dify Knowledge Base icon

Dify Knowledge Base

Manage Dify AI knowledge base datasets, documents, segments, and metadata with comprehensive CRUD operations

Actions30

Dataset → Delete

AI-generated

Overview

The node manages datasets within the Dify AI knowledge base platform, specifically allowing users to delete a dataset by its unique identifier. This operation is useful when you want to remove an entire dataset from your knowledge base, for example, to clean up outdated or irrelevant data collections.

Practical scenarios include:

  • Removing test or temporary datasets after validation.
  • Deleting datasets that are no longer needed to free up storage or reduce clutter.
  • Automating dataset lifecycle management in workflows where datasets are created and deleted dynamically.

Properties

Name Meaning
Dataset ID The unique identifier of the dataset to delete

Output

The output JSON contains the response from the deletion operation. Typically, this will confirm whether the dataset was successfully deleted or provide details about the deletion status. The exact structure depends on the API response but generally includes confirmation fields or error messages if the deletion failed.

This node does not output binary data.

Dependencies

  • Requires an API key credential to authenticate with the Dify AI knowledge base service.
  • Needs the base URL of the Dify API configured in the node credentials.
  • Relies on the external Dify AI knowledge base API to perform dataset deletion.

Troubleshooting

  • Common issues:

    • Invalid or missing Dataset ID: Ensure the Dataset ID provided exists and is correctly formatted.
    • Authentication errors: Verify that the API key and base URL credentials are correctly set up.
    • Permission errors: The API key used must have sufficient permissions to delete datasets.
    • Network or connectivity problems: Check internet connection and API endpoint accessibility.

  • Error messages:

    • "The operation "delete" is not supported for resource "dataset": This indicates a misconfiguration in the operation parameter; ensure "delete" is selected.
    • API errors returned from the Dify service (e.g., 404 Not Found if the dataset does not exist) will be passed through; check the dataset ID and permissions.
    • NodeOperationError with message about unsupported resource or operation means the node parameters are incorrectly set.

Resolving these typically involves verifying input parameters, credentials, and network access.

Links and References

Discussion