---
title: "Get projects using a given workflow"
method: GET
path: "/rest/api/2/workflow/{workflowId}/projectUsages"
tags: ["Workflows"]
---

# Get projects using a given workflow

`GET /rest/api/2/workflow/{workflowId}/projectUsages`

Returns a page of projects using a given workflow.

## Path parameters

- `workflowId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- WorkflowProjectUsageDTO — Projects using the workflow.
  - `projects` ProjectUsagePage — A page of projects.
    - `nextPageToken` string — Page token for the next page of project usages.
    - `values` ProjectUsage[] — The list of projects.
      - `id` string — The project ID.
  - `workflowId` string — The workflow ID.

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing, or the caller doesn't have permissions to perform the operation.
- `404` — Returned if the workflow with the given ID does not exist.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/revisions/40fd882d2209/schema)