awork

Overview

This node allows you to create a new project status within a specified project using the awork API. It is useful for automating project management workflows, such as adding custom status stages (e.g., "In Review", "Blocked") to projects in your awork workspace. For example, you might use this node to automatically add a "QA" status to every new project created via an onboarding workflow.

Properties

Output

The output will contain a json field with details about the newly created project status. Typical fields may include:

{
  "id": "string",
  "name": "string",
  "type": "string",
  "projectId": "string",
  // ...other status properties as returned by the awork API
}

• id: The unique identifier of the new status.
• name: The name of the status.
• type: The type/category of the status.
• projectId: The ID of the project to which the status belongs.

Dependencies

• awork API: Requires access to the awork API.
• API Key: You must configure valid awork API credentials in n8n under the name aworkApi.
• n8n Configuration: No additional environment variables are needed beyond standard credential setup.

Troubleshooting

• Missing or Invalid Project ID: If the provided Project ID does not exist or is incorrect, the node may return an error indicating that the project was not found.
• Insufficient Permissions: If the API key does not have permission to modify the project, you may receive an authorization error.
• Duplicate Status Name: Attempting to create a status with a name that already exists in the project may result in an error from the awork API.
• Common Error Messages:
  • "Project not found": Check that the Project ID is correct and exists in awork.
  • "Unauthorized": Ensure your awork API credentials are valid and have sufficient permissions.
  • "Status name already exists": Use a unique status name for each project.

Links and References

• awork API Documentation
• n8n Documentation: Credentials
• n8n Community Forum