Actions27
- Project Actions
- Project Task Actions
- User Actions
- Company Actions
Overview
This node integrates with the awork API to automate project management workflows. Specifically, the "Create Project Status" operation allows users to add a new status to a project within awork. This is useful for teams that want to customize or extend their project tracking by defining additional statuses beyond the default ones.
Practical examples include:
- Adding a custom status like "In Review" or "Blocked" to better reflect your team's workflow stages.
- Automating project setup by programmatically creating necessary statuses when a new project is created.
- Synchronizing project statuses from another system into awork via automation.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project where the new status will be created. |
| Status Name | The name of the new status to create (e.g., "Not Started", "In Progress", "Completed"). |
| Status Type | The type/category of the status. This typically defines how the status behaves or is grouped. |
Output
The node outputs JSON data representing the newly created project status object as returned by the awork API. This includes details such as the status ID, name, type, and any other metadata provided by the API.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the awork API.
- The node uses the base URL
https://api.awork.comand expects JSON content-type headers. - Proper permissions on the awork account are needed to create project statuses.
Troubleshooting
- Invalid Project ID: If the provided 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: Both "Status Name" and "Status Type" are required. Omitting these will cause validation errors.
- Authentication Errors: Ensure 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 backoff strategies if needed.
Links and References
- awork API Documentation
- awork Project Statuses API Endpoint (for detailed request/response schema)