Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, allowing users to perform a wide range of administrative and operational tasks on a Dataiku DSS instance. Specifically, for the DSS Administration - Delete Tag operation, it enables deleting a tag from a global tag category within the DSS environment.

Common scenarios where this node is beneficial include managing metadata tags used for organizing datasets, projects, or other DSS objects, cleaning up obsolete tags, or automating tag lifecycle management as part of larger workflows.

For example, if an organization uses tags extensively to classify data assets and needs to remove deprecated tags programmatically, this node can be configured to delete those tags automatically based on workflow logic.

Properties

Name Meaning
Category Name The name of the global tag category from which the tag will be deleted.
Tag Name The specific tag name to delete within the specified category.
Query Parameters Optional additional query parameters that can be sent with the request (key-value pairs).

These properties are required to identify precisely which tag in which category should be deleted.

Output

The output of the node is a JSON array containing the response from the Dataiku DSS API after attempting to delete the tag. Typically, for a delete operation, the response might be empty or contain status information confirming the deletion.

If the operation involves downloading files or binary content (not applicable for Delete Tag), the node would return binary data prepared accordingly.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key) for authentication with the DSS API.
  • The node expects the base URL of the DSS server and the user API key credential to be configured in n8n.

Troubleshooting

  • Missing Credentials Error: If the API key or server URL is not provided, the node throws an error indicating missing credentials.
  • Required Parameter Missing: The node validates required parameters such as "Category Name" and "Tag Name" before making the API call. If these are missing, it throws descriptive errors.
  • API Request Failures: Errors returned by the DSS API (e.g., tag not found, permission denied) will be surfaced as node execution errors with messages prefixed by "Error calling Dataiku DSS API".
  • Invalid Resource or Operation: If an unsupported resource or operation is selected, the node throws an error indicating unknown resource or operation.

To resolve issues:

  • Ensure all required input fields are correctly filled.
  • Verify API credentials and permissions.
  • Check the DSS server URL and network connectivity.
  • Review the exact error message for clues about API-level problems.

Links and References


This summary focuses on the DSS Administration - Delete Tag operation extracted from the provided source code and property definitions.

Discussion