awork icon

awork

Automate your workflows with the awork API

Overview

The Change Project Status operation for the Project resource in this n8n node allows you to update the status of a specific project within the awork platform. This is useful for automating project management workflows, such as moving projects through different phases (e.g., from "In Progress" to "Completed") based on triggers or other automation logic.

Common scenarios:

  • Automatically updating a project's status when certain tasks are completed.
  • Integrating with other tools to reflect project progress.
  • Batch-updating project statuses as part of a larger workflow.

Example:
When a client approves a deliverable, automatically set the related project's status to "Approved" in awork.


Properties

Display Name Type Meaning
Project ID String The unique identifier of the project whose status you want to change.
Project Status ID String The identifier of the new status to assign to the project.

Output

The output will be a json object reflecting the updated state of the project after its status has been changed. The structure typically includes fields such as:

{
  "id": "string",                // Project ID
  "name": "string",              // Project name
  "statusId": "string",          // New status ID
  "status": {                    // Status details
    "id": "string",
    "name": "string"
  },
  // ...other project fields
}

Note: The actual output may include additional project-related fields depending on the awork API response.


Dependencies

  • External Service: Requires access to the awork API.
  • API Key: You must configure valid awork API credentials in n8n under the credential type aworkApi.
  • Environment: No special environment variables required beyond standard n8n and credential setup.

Troubleshooting

Common Issues:

  • Invalid Project ID: If the provided Project ID does not exist, the node will likely return an error indicating that the project was not found.
  • Invalid Project Status ID: If the Project Status ID is invalid or not applicable to the project, the API may reject the request.
  • Missing Credentials: If awork API credentials are not configured, the node will fail to authenticate.

Error Messages & Resolutions:

  • "Project not found": Double-check the Project ID.
  • "Status not found" or "Invalid status": Ensure the Project Status ID is correct and available for the given project.
  • "Authentication failed": Verify your awork API credentials in n8n.

Links and References

Discussion