awork icon

awork

Automate your workflows with the awork API

Actions26

Overview

This node retrieves a specific Project Task from the awork API using its unique Task ID. It is useful in scenarios where you need to fetch detailed information about a particular task within a project, such as for reporting, automation, or integration with other systems. For example, you might use this node to look up a task's status, assignee, or custom fields before taking further action in your workflow.

Properties

Display Name Type Meaning
Task ID String The unique identifier of the task to retrieve. This is required.
  • Task ID: Enter the ID of the task you want to fetch. This property is mandatory and should be set to the value corresponding to the desired task in awork.

Output

The output will be a JSON object containing all available details about the specified Project Task. Typical fields may include:

{
  "id": "string",
  "name": "string",
  "description": "string",
  "status": "string",
  "assignee": {
    "id": "string",
    "name": "string"
  },
  "customFields": [
    {
      "fieldId": "string",
      "value": "any"
    }
  ],
  ...
}
  • The actual structure depends on the awork API response for a single task.
  • If the task includes binary attachments, these will be referenced in the output but not included directly.

Dependencies

  • awork API: Requires an active awork account and access to the awork API.
  • API Key: You must configure the aworkApi credential in n8n with a valid API key.
  • Environment: No additional environment variables are required beyond standard n8n setup.

Troubleshooting

  • Invalid Task ID: If the provided Task ID does not exist, the node may return an error such as "Task not found" or a 404 HTTP error. Double-check the Task ID for typos.
  • Authentication Errors: If the API key is missing or invalid, you may see errors like "Unauthorized" or "Invalid credentials." Ensure your aworkApi credential is correctly configured.
  • Network Issues: Connectivity problems can result in timeout or network-related errors. Verify your network connection and awork API availability.

Links and References

Discussion