awork icon

awork

Automate your workflows with the awork API

Overview

The Set Task Assignee operation for the Project Task resource in this n8n node allows you to assign a specific user to a project task within the awork platform. This is useful for automating task management workflows, such as automatically assigning tasks to team members based on certain triggers or conditions.

Common scenarios:

  • Automatically assigning new tasks to users when they are created.
  • Reassigning tasks as part of workflow automation (e.g., when a task status changes).
  • Integrating with other systems to synchronize assignees.

Practical example:
When a new support ticket is received, create a corresponding project task in awork and use this operation to assign it to the appropriate support agent.


Properties

Display Name Type Meaning
Task ID String The unique identifier of the project task you want to assign a user to.
User ID String The unique identifier of the user who will be assigned to the task.

Output

The output will contain the result of the assignment operation. Typically, this includes the updated task information in the json field, reflecting the new assignee. The exact structure depends on the awork API response, but you can expect fields such as:

{
  "id": "string",           // Task ID
  "assigneeId": "string",   // User ID of the new assignee
  // ...other task details
}

Note: No binary data is produced by this operation.


Dependencies

  • External Service: Requires access to the awork API.
  • API Key: You must configure valid awork API credentials (aworkApi) in your n8n instance.
  • Environment: Ensure your n8n instance can reach https://api.awork.com.

Troubleshooting

Common issues:

  • Invalid Task ID or User ID: If either ID is incorrect or does not exist, the operation may fail with an error from the awork API.
  • Missing Credentials: If the awork API credentials are not set up correctly, authentication errors will occur.
  • Insufficient Permissions: The API key used must have permission to update tasks and assign users.

Error messages and resolutions:

  • "Task not found": Verify that the Task ID exists in awork.
  • "User not found": Check that the User ID is correct and the user exists.
  • "Unauthorized": Ensure your API credentials are valid and have the necessary permissions.

Links and References

Discussion