Planka icon

Planka

Interact with Planka API

Overview

The Update Project Background operation for the 🏢 PROJECT resource in this n8n node allows you to change the background image of a specific project in Planka. This is useful for visually customizing projects, improving team recognition, or branding within your Planka workspace.

Common scenarios:

  • Updating a project's background to reflect its current status or theme.
  • Branding projects with company or client-specific images.
  • Quickly changing visuals for seasonal events or campaigns.

Practical example:
You have a "Marketing Campaign" project and want to update its background image to match the latest campaign graphics. Using this node operation, you can automate the upload of a new background image as part of your workflow.


Properties

Name Type Meaning
Project ID String The unique identifier of the project to update.
Background Image File String The file (path or binary reference) to upload as the new background image for the project.

Output

  • The output will be a JSON object representing the updated project after the background image has been changed.
  • The structure typically includes project details such as id, name, and updated background information.
  • If an error occurs and "Continue On Fail" is enabled, the output will include a field like:
    { "error": "Error message here" }
    

Dependencies

  • External Service: Requires access to a running Planka API instance.
  • Authentication: Needs valid Planka API credentials configured in n8n under the credential type plankaApi.
  • n8n Configuration: The file to upload must be accessible to n8n (either as a path or from previous workflow steps).

Troubleshooting

Common issues:

  • Invalid Project ID: If the provided Project ID does not exist, the API will return an error.
  • File Not Found/Accessible: If the specified file cannot be found or accessed by n8n, the upload will fail.
  • API Authentication Errors: Invalid or missing API credentials will result in authentication errors.

Error messages and resolutions:

  • "Project not found": Check that the Project ID is correct and exists in Planka.
  • "File required" or "Cannot read file": Ensure the file path or binary data is correctly provided and accessible.
  • "Unauthorized": Verify that the Planka API credentials are set up properly in n8n.

Links and References

Discussion