Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to perform a wide range of operations on Dataiku DSS resources programmatically. Specifically for the Project resource and the Update Project Permissions operation, it allows updating access permissions for a given project in Dataiku DSS.

Common scenarios where this node is beneficial include automating project permission management as part of CI/CD pipelines, synchronizing permissions across multiple projects, or integrating Dataiku DSS project security settings into broader organizational workflows.

For example, you can use this node to update who has read, write, or admin access to a project automatically when onboarding new team members or changing project roles.

Properties

Name Meaning
Project Key The unique identifier key of the project whose permissions you want to update.
Request Body JSON object containing the details of the permissions update to apply to the project.

The Request Body property expects a JSON structure that defines the new permissions settings for the project. This typically includes user or group identifiers and their corresponding access levels.

Output

The node outputs the response from the Dataiku DSS API call in the json field of the output data. This response reflects the result of the permissions update operation, which may include confirmation of success or details about the updated permissions.

If the API returns binary data (not typical for this operation), it would be provided in the binary field, but for updating project permissions, the output is expected to be JSON.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key) for authentication with the Dataiku DSS server.
  • The node uses HTTP requests to communicate with the Dataiku DSS REST API.
  • The base URL for the API is constructed using the configured DSS server address.
  • Proper permissions are required on the API key to update project permissions.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the API key credential for Dataiku DSS is properly configured in n8n.
  • Project Key Required: The operation requires a valid project key; if omitted or incorrect, the node will throw an error.
  • Invalid Request Body: The request body must be valid JSON matching the expected schema for permissions updates; malformed JSON or incorrect fields will cause API errors.
  • API Errors: Errors returned by the Dataiku DSS API (e.g., unauthorized, forbidden, not found) will be surfaced by the node. Check that the API key has sufficient rights and that the project exists.
  • Network Issues: Connectivity problems to the DSS server will cause request failures; verify network access and server availability.

Links and References


Note: This summary focuses on the "Project" resource and the "Update Project Permissions" operation as requested. The node supports many other resources and operations beyond this scope.

Discussion