awork icon

awork

Automate your workflows with the awork API

Actions27

Overview

This node integrates with the awork API to automate workflows related to project management. Specifically, for the "Project" resource and the "Get Task Lists of Project" operation, it retrieves all task lists associated with a specified project. This is useful when you want to programmatically access the structure of tasks within a project, for example, to display them in a dashboard, synchronize with other tools, or trigger further automation based on task list data.

Practical examples:

  • Fetching all task lists of a project to generate reports.
  • Synchronizing task lists with an external project management tool.
  • Triggering notifications or actions when certain task lists are retrieved or updated.

Properties

Name Meaning
Project ID The unique identifier of the project whose task lists you want to retrieve. This is a required string input where you enter the project ID.

Output

The node outputs JSON data containing the task lists of the specified project. Each item in the output corresponds to a task list object as returned by the awork API. The structure typically includes details such as task list IDs, names, statuses, and possibly metadata related to each task list.

If the node supports binary data output (not indicated here), it would represent attachments or files related to the task lists, but this operation primarily returns JSON data.

Dependencies

  • Requires an active connection to the awork API via an API key credential.
  • The node expects the base URL https://api.awork.com and uses standard JSON headers.
  • Proper configuration of the API authentication token in n8n credentials is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Project ID: Ensure the Project ID is correctly provided and exists in awork.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or connectivity problems: Check internet connection and API availability.

  • Common error messages:

    • 401 Unauthorized: Indicates invalid or expired API credentials. Re-authenticate with a valid API key.
    • 404 Not Found: The specified Project ID does not exist. Double-check the ID.
    • 400 Bad Request: Input parameters may be malformed or missing. Confirm the Project ID format.

Resolving these usually involves verifying inputs, refreshing credentials, and ensuring the awork service is operational.

Links and References

Discussion