Overview
This node integrates with the Motion API to manage tasks within workspaces. Specifically, the "Task - Get All" operation retrieves a list of tasks from a specified workspace, optionally filtered by project, status, or assignee. It supports returning either all matching tasks or a limited subset.
Common scenarios include:
- Fetching all tasks in a workspace for reporting or synchronization.
- Filtering tasks by project or assignee to focus on relevant subsets.
- Retrieving tasks by their status (e.g., To Do, In Progress, Done) to monitor progress.
Practical example:
- A project manager wants to pull all "In Progress" tasks assigned to a specific team member within a workspace to review workload and update statuses.
Properties
| Name | Meaning |
|---|---|
| Workspace ID | The unique identifier of the workspace from which to retrieve tasks. |
| Return All | Boolean flag indicating whether to return all matching tasks (true) or limit the results (false). |
| Limit | Maximum number of tasks to return when Return All is false. Value range: 1 to 100. |
| Filters | Collection of optional filters to narrow down tasks: |
| Project ID | Filter tasks by the ID of the project they belong to. |
| Status | Filter tasks by their status. Options: "To Do", "In Progress", "Done". |
| Assignee ID | Filter tasks by the ID of the user assigned to them. |
Output
The output is a JSON array where each element represents a task object retrieved from the Motion API. Each task object includes details such as task ID, title, description, project association, assignee, due date, status, priority, and other metadata as provided by the API.
No binary data is returned by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Motion API.
- The node makes HTTP requests to the Motion API endpoint at
https://api.usemotion.com/v1. - Proper configuration of the API key credential in n8n is necessary for successful execution.
Troubleshooting
- Common issues:
- Missing or invalid API key will cause authentication failures.
- Providing an incorrect Workspace ID may result in empty results or errors.
- Exceeding the allowed limit (above 100) will be rejected by the node's input validation.
- Error messages:
- Errors from the API (e.g., 401 Unauthorized) indicate credential problems; verify the API key.
- If no tasks are returned, check that the workspace ID and filters are correct.
- If the node throws "Please specify at least one field to update" error, it indicates misuse of update operation fields (not applicable here but relevant for other operations).
Links and References
- Motion API Documentation (for detailed API endpoints and data structures)
- n8n documentation on HTTP Request Node (conceptual understanding of underlying HTTP calls)