Planka

Overview

The Sort Board List operation for the 📋 BOARD resource in this n8n node allows you to reorder cards within a specific list on a Planka board. This is useful when you want to programmatically define the exact order of cards (tasks, items, etc.) in a list, such as after a bulk update, based on priority, or as part of an automated workflow.

Practical scenarios:

• Automatically sorting cards by due date, priority, or custom logic.
• Reordering cards after importing data from another system.
• Ensuring a consistent card order after batch operations.

Properties

Output

• The output will be a JSON object containing the response from the Planka API after attempting to sort the cards in the specified list.
• Typically, this response may include a status message or the updated list structure, depending on the API's implementation.
• If an error occurs and "Continue On Fail" is enabled, the output will contain a JSON object with an error field describing the issue.

Example output:

{
  "success": true
}

or, in case of error:

{
  "error": "List not found"
}

Dependencies

• Planka API: Requires access to a running Planka instance.
• API Credentials: You must configure the plankaApi credentials in n8n for authentication.
• No additional environment variables are required beyond standard n8n credential setup.

Troubleshooting

Common issues:

• Invalid List ID: If the provided List ID does not exist, the API will return an error.
• Malformed Card IDs: If Card IDs are missing, invalid, or not comma-separated, the sort operation may fail.
• Insufficient Permissions: The user associated with the API credentials must have permission to modify the list.

Error messages and resolutions:

• "List not found": Check that the List ID is correct and exists in your Planka instance.
• "Invalid card IDs": Ensure all Card IDs are valid and belong to the specified list.
• "Unauthorized": Verify your API credentials and permissions.

Links and References

• Planka GitHub Repository
• n8n Documentation: Custom Nodes
• Planka API Reference (if available)