🚨 Upcoming API Change for Workflows: project and task statuses can be shared across projects

Developer Forum
1

We will soon start rolling out a new feature called Workflows which brings project and task statuses that are shared across projects. This might have an impact on existing integrations using our API to manage projects and tasks.

We’re holding the rollout for all affected workspaces where these endpoints are used to make sure nothing breaks on your end.

Am I affected?

Status models (project statuses, task statuses) currently always return a projectId. Going forward, this projectId can be null or undefined — and workflowId is set instead for projects that use the new Workflows feature in awork.

If your integration fetches statuses and filters by projectId, it will return incomplete results.

How to migrate

Use the project-scoped status endpoints. These return all relevant statuses for a project regardless of how they’re configured:

GET /projects/{projectId}/projectstatuses
GET /projects/{projectId}/taskstatuses
GET /projecttemplates/{projectTemplateId}/projectstatuses
GET /projecttemplates/{projectTemplateId}/taskstatuses

:backhand_index_pointing_right: Full migration guide

Let us know as soon as your integration is updated

The change should only take about 5 minutes. Let us know once you’ve made the change or confirmed your integration is not affected — we’ll roll out the new features to your workspace and all that use your integration.

The deadline for making this change is July 31, 2026. After that, the change rolls out automatically for everyone.

Questions? Just reply here.

3

Hi Sebastan,

as i understand right, i can now create a workflow for external Projects where i set up statuses, and tasks in that Project have the same Status id ?

Greetings Tim

4

Hi @tim.guersch, yes, the goal is that workflows define project and task statuses that can be shared across projects that use this workflow and therefore use the same id. The feature is not released yet and therefore not in the API Docs, but will be coming soon.

5

Hi Sebastian,

can you tell me when it is planed to release the API Docs for the Update?

6

@tim.guersch I’m currently planning with end of next week.

7

@tim.guersch Workflow API docs are online now: Workflows | awork API | Documentation

Be aware that the feature is not available in every workspace yet and will be rolled out over the next ~3 weeks.