Actions27
- Project Actions
- Project Task Actions
- User Actions
- Company Actions
Overview
This node integrates with the awork API to automate project management workflows. Specifically, for the Project resource and the Create Task Status operation, it allows users to create a new task status within a specified project. This is useful for teams that want to customize their task tracking by defining statuses such as "Not Started," "In Progress," or "Completed" with associated icons.
Practical examples include:
- Adding a new custom status like "Waiting for Review" to better reflect your team's workflow.
- Creating a status with a specific icon to visually distinguish task states in dashboards or reports.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project where the new task status will be created. |
| Status Name | The name of the new task status (e.g., "Not Started", "In Progress"). |
| Status Type | The type/category of the status. This typically defines how the status behaves or is grouped. |
| Task Status Icon | The icon representing the task status visually (e.g., "arrow_forward"). |
Output
The node outputs JSON data representing the newly created task status object returned from the awork API. This includes details such as the status ID, name, type, icon, and any other metadata provided by the API.
If the node supports binary data output (not indicated here), it would typically relate to attachments or media associated with the task status, but this operation primarily deals with JSON data.
Dependencies
- Requires an active connection to the awork API.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL for API requests is
https://api.awork.com. - Proper permissions on the awork account to create task statuses within projects.
Troubleshooting
- Invalid Project ID: If the project ID does not exist or is incorrect, the API will return an error. Verify the project ID before running the node.
- Missing Required Fields: Ensure all required properties (
Project ID,Status Name,Status Type,Task Status Icon) are provided; otherwise, the request will fail. - Authentication Errors: Check that the API key credential is valid and has sufficient permissions.
- API Rate Limits: If many requests are made in a short time, the API might throttle requests. Implement retries or delays if needed.
Links and References
- awork API Documentation
- awork Task Statuses Guide (example link, replace with actual if available)