Actions25
Overview
The node enables updating a task in the Whoz talent management platform. It allows users to modify various attributes of an existing task by specifying its unique Task ID and providing updated values for one or more fields. This operation is useful for managing project tasks dynamically, such as changing deadlines, reassigning owners, adjusting priorities, or updating budget and workload details.
Practical examples include:
- Updating the due date or priority of a task when project timelines shift.
- Changing the assignees or owner of a task based on team availability.
- Modifying budgeted days or revenue targets as project scope evolves.
- Adding or revising requirements like expected skills or remote work permissions.
Properties
| Name | Meaning |
|---|---|
| Task ID | The unique identifier of the task to update. |
| Additional Fields | Optional fields to update various task attributes: - External ID: Identifier from an external system. - Description: Text description of the task. - Type: Task type (Request, Assignment, Position). - Priority: Task priority level (Low, Medium, High, Urgent). - Start Date: When the task starts. - End Date: When the task ends. - Due Date: Deadline for the task. - Assignee IDs: Comma-separated list of assignee identifiers. - Assignee External IDs: Comma-separated list of external assignee IDs. - Owner ID: Identifier of the task owner. - Owner External ID: External identifier of the task owner. - Project ID: Identifier of the associated project. - Project External ID: External identifier of the associated project. - Tags: Comma-separated list of tags related to the task. |
| Budget & Workload | Optional budget and workload-related fields: - Budgeted Days: Number of days budgeted for the task. - Budgeted Revenue Value: Expected revenue amount. - Budgeted Revenue Currency: Currency for revenue (EUR, USD, GBP, CHF, CAD). - Budgeted Cost Value: Expected cost amount. - Budgeted Cost Currency: Currency for cost (EUR, USD, GBP, CHF, CAD). - Target Daily Rate Value: Target daily rate. - Target Daily Rate Currency: Currency for daily rate (EUR, USD, GBP, CHF, CAD). |
| Requirements | Optional requirement-related fields: - Expected Skills: Comma-separated list of required skill names. - Expected Qualifications: Comma-separated list of required qualification names. - Required Experience Years: Minimum years of experience. - Location: Physical location or work site. - Remote Work Allowed: Boolean indicating if remote work is permitted. |
Output
The output is a JSON object representing the updated task as returned by the Whoz API. It typically includes all current properties of the task after the update, reflecting any changes made. The structure corresponds to the task entity in the Whoz platform, including identifiers, descriptive fields, dates, assignments, budget/workload data, and requirements.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Whoz talent management platform via an OAuth2 API credential.
- The node uses the Whoz REST API endpoints to perform updates.
- Proper API authentication credentials must be configured in n8n with access rights to modify tasks.
- The base URL depends on the environment setting (sandbox or production).
Troubleshooting
- Missing or invalid Task ID: The update operation requires a valid Task ID. If omitted or incorrect, the node will throw an error indicating the missing or invalid identifier.
- API authentication errors: Ensure that the OAuth2 credentials are correctly set up and have sufficient permissions.
- Invalid field values: Providing unsupported or incorrectly formatted values (e.g., invalid dates, wrong currency codes) may cause API errors. Validate inputs before running the node.
- Network or connectivity issues: Temporary network failures can cause request timeouts or failures. Retrying or checking network status may help.
- Partial updates: Only fields provided in the input are updated; others remain unchanged. Omitting required fields for certain workflows might lead to inconsistent data.
Links and References
- Whoz Talent Management Platform
- Whoz API Documentation (requires login)
- n8n Documentation on Creating Custom Nodes