Actions31
Overview
The node integrates with the Steuerboard API to list tasks associated with a client. It allows users to retrieve multiple tasks filtered optionally by workspace or parent task, supporting pagination and limiting the number of results returned. This is useful in scenarios where you want to fetch task data for project management, reporting, or synchronization purposes.
For example, you might use this node to:
- Retrieve all tasks for a specific client to display in a dashboard.
- Filter tasks within a particular workspace or under a parent task to organize hierarchical task structures.
- Paginate through large sets of tasks efficiently.
Properties
| Name | Meaning |
|---|---|
| Client ID | The ID of the client whose tasks you want to list (required). |
| Workspace ID | Optional filter to list tasks only within a specific workspace. |
| Parent ID | Optional filter to list tasks that are children of a specific parent task. |
| Return All | Whether to return all matching tasks or limit the number of results. |
| Limit | Maximum number of tasks to return if not returning all (minimum 1, maximum 100). |
| Cursor | Cursor string used for pagination to fetch the next page of results. |
Output
The node outputs a JSON array of task objects retrieved from the Steuerboard API. Each object represents a task with its properties as defined by the API (e.g., task ID, name, status, etc.). If pagination is enabled and "Return All" is true, the node will automatically paginate through all available tasks.
If binary data were involved (not indicated here), it would be summarized accordingly, but this node focuses on JSON task data.
Dependencies
- Requires an API key credential for authenticating with the Steuerboard API.
- Needs the base URL of the Steuerboard API configured in the credentials.
- The node uses HTTP requests to the Steuerboard API endpoints to fetch task data.
Troubleshooting
- Missing or invalid Client ID: Since Client ID is required, ensure it is provided and valid; otherwise, the API may reject the request.
- Pagination issues: If using cursors for pagination, ensure the cursor value is correctly passed; an invalid cursor may cause errors or empty results.
- API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Rate limits or API errors: The Steuerboard API may impose rate limits; handle such errors by retrying after some delay or reducing request frequency.
Links and References
- Steuerboard API documentation (refer to official docs for detailed API endpoint descriptions and task object schema).
- n8n documentation on pagination and API integrations for best practices.