Plutio icon

Plutio

Consume Plutio API
Join our community

Actions20

Overview

The Plutio Task Get operation node allows you to retrieve tasks from your Plutio workspace based on various filter criteria. This is useful for automating workflows that need to fetch task details, such as reporting, monitoring project progress, or integrating with other tools (e.g., sending reminders for specific tasks, syncing tasks to another system, or generating custom dashboards).

Practical examples:

  • Fetch all tasks assigned to a particular user in a project.
  • Retrieve tasks from a specific task board or group for status updates.
  • Find a task by its unique ID to get detailed information.

Properties

Name Type Meaning
Task ID String The unique identifier of the task to retrieve.
Project Name or ID Options Select or specify the project to filter tasks by. You can choose from a list or use an expression to provide the project name or ID directly.
Task Board Name or ID Options Select or specify the task board to filter tasks by. You can choose from a list or use an expression to provide the board name or ID directly.
Task Group Name or ID Options Select or specify the task group to filter tasks by. You can choose from a list or use an expression to provide the group name or ID directly.
Creator Name or ID Options Select or specify the creator of the task. You can choose from a list or use an expression to provide the user's name or ID directly.
Title String Filter tasks by their title.

All these properties are grouped under the "Options" collection.

Output

  • The output is a JSON array of task objects matching the specified filters.
  • Each object contains the full details of a task as returned by the Plutio API. Typical fields may include:
    • _id: Task ID
    • title: Task title
    • descriptionHTML: Task description (if available)
    • projectId, taskBoardId, taskGroupId: IDs referencing related entities
    • createdBy: User ID of the creator
    • Additional metadata and custom fields depending on your Plutio setup

Example output:

[
  {
    "_id": "abc123",
    "title": "Design homepage",
    "descriptionHTML": "<p>Initial design draft</p>",
    "projectId": "proj456",
    "taskBoardId": "board789",
    "taskGroupId": "group101",
    "createdBy": "user202",
    // ...other fields
  }
]
  • Binary data: This operation does not return binary data.

Dependencies

  • External Service: Requires access to the Plutio API.
  • API Credentials: You must configure valid Plutio API credentials (plutioApi) in n8n.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common issues:

  • Invalid or missing credentials: If your Plutio API credentials are not set up correctly, the node will fail to connect.
  • Incorrect IDs or names: Providing a non-existent Task ID, Project ID, etc., will result in no results or errors.
  • Insufficient permissions: The connected Plutio account must have permission to view the requested tasks.

Error messages and resolutions:

  • "Request failed with status code 401": Check your API credentials.
  • "Task not found" or empty result: Verify the provided Task ID or filter values.
  • "Cannot read property '...' of undefined": Some referenced entity (like project or user) does not exist; double-check your input options.

Links and References

Discussion