Actions31
Overview
The node integrates with the Steuerboard API to update an existing task. It allows users to modify various attributes of a task such as its title, text content, due date, and status. This is useful in scenarios where task details need to be dynamically changed based on workflow conditions, for example updating a task's status when a related process completes or changing the due date based on new scheduling information.
Practical examples:
- Automatically marking a task as "In Progress" when work starts.
- Updating the due date of a task based on external calendar events.
- Changing the task's title or description to reflect updated requirements.
Properties
| Name | Meaning |
|---|---|
| Client ID | The unique identifier of the client to which the task belongs. |
| Task ID | The unique identifier of the task that you want to update. |
| Fields | A collection of fields to update on the task. Includes: |
| - Title | The new title of the task. |
| - Text | The new descriptive text/content of the task. |
| - Due Date | The new due date for the task, specified in ISO 8601 format (e.g., 2024-12-31T23:59:59Z). |
| - Status | The current status of the task. Options are: Accepted, Declined, In Progress, In Review, Open. |
Output
The node outputs JSON data representing the updated task object as returned by the Steuerboard API. This typically includes all task properties after the update, such as the updated title, text, due date, status, and any other metadata provided by the API.
If the node supports binary data output, it would relate to file attachments or similar, but this operation focuses on task updates and does not handle binary data.
Dependencies
- Requires access to the Steuerboard API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- The base URL for the API must be set in the credentials configuration.
Troubleshooting
- Missing Required Fields: If Client ID or Task ID is not provided, the node will fail because these are mandatory to identify which task to update.
- Invalid Date Format: The due date must be in valid ISO 8601 format; otherwise, the API may reject the request.
- Status Value Errors: Providing a status outside the allowed options will cause errors.
- API Authentication Failures: Ensure the API key/token is valid and has permissions to update tasks.
- Network Issues: Connectivity problems to the Steuerboard API endpoint can cause timeouts or failures.
To resolve errors, verify all required inputs, confirm correct formatting, and check API credentials and network connectivity.
Links and References
- Steuerboard API Documentation (refer to official docs for detailed API endpoints and field specifications)
- ISO 8601 Date Format Reference: https://en.wikipedia.org/wiki/ISO_8601