Planka

Interact with Planka API

Actions46

Overview

The Update Task operation for the 📝 CARD resource in this n8n node allows you to update an existing task within a card in Planka, a project management platform. This is useful when you need to programmatically change the details of a task, such as its name, position, or completion status, as part of an automated workflow.

Common scenarios:

Renaming a task after requirements change.
Reordering tasks within a card based on priority.
Marking a task as completed or not completed from another system or trigger.

Practical example:
You might use this node in a workflow that syncs tasks from another tool (like Jira or Trello) into Planka, updating their status or details whenever changes are detected.

Properties

Name	Type	Meaning
Task ID	string	The unique identifier of the task to be updated.
Task Name	string	The new name/title for the task.
Task Position	number	The new position/order of the task within the card.
Is Completed	boolean	Whether the task should be marked as completed (`true`/`false`).

Output

The output will be a JSON object representing the updated task as returned by the Planka API. The structure typically includes fields such as:

{
  "id": "string",
  "name": "string",
  "position": number,
  "isCompleted": boolean,
  // ...other task-related fields as provided by Planka
}

If the update is successful, the output contains the full details of the updated task.
If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

Planka API: Requires access to a running Planka instance.
API Credentials: You must configure the plankaApi credentials in n8n for authentication.

Troubleshooting

Common issues:

Invalid Task ID: If the provided Task ID does not exist, the API will return an error.
Missing Required Fields: All required properties (Task ID, Task Name) must be provided.
Permission Denied: The API credentials used must have permission to update tasks in the target card.

Error messages:

"Task not found": Check that the Task ID is correct and exists in Planka.
"Unauthorized" or "Forbidden": Ensure your API credentials are valid and have sufficient permissions.
"Validation failed": One or more input values are invalid; check types and required fields.