---
title: "POST /v1/spaces/{spaceName}/projects/{projectName}/workflowRuns"
method: POST
path: "/v1/spaces/{spaceName}/projects/{projectName}/workflowRuns"
---

# POST /v1/spaces/{spaceName}/projects/{projectName}/workflowRuns

`POST /v1/spaces/{spaceName}/projects/{projectName}/workflowRuns`

Retrieves a list of workflow runs of a specified workflow.

## Path parameters

- `spaceName` string, required
- `projectName` string, required

## Query parameters

- `workflowId` string
- `nextToken` string
- `maxResults` integer

## Request body

- object
  - `sortBy` WorkflowRunSortCriteria[] — Information used to sort the items in the returned list.

## Response `200`

Success

- ListWorkflowRunsResponse
  - `nextToken` string — A token returned from a call to this API to indicate the next batch of results to return, if any.
  - `items` WorkflowRunSummary[] — Information about the runs of a workflow.
    - `id` string, required — The system-generated unique ID of the workflow run.
    - `workflowId` string, required — The system-generated unique ID of the workflow.
    - `workflowName` string, required — The name of the workflow.
    - `status` 'SUCCEEDED' | 'FAILED' | 'STOPPED' | 'SUPERSEDED' | 'CANCELLED' | 'NOT_RUN' | 'VALIDATING' | 'PROVISIONING' | 'IN_PROGRESS' | 'STOPPING' | 'ABANDONED', required — The status of the workflow run.
    - `statusReasons` WorkflowRunStatusReason[] — The reasons for the workflow run status.
    - `startTime` string, date-time, required — The date and time the workflow run began, in coordinated universal time (UTC) timestamp format as specified in <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339</a>.
    - `endTime` string, date-time — The date and time the workflow run ended, in coordinated universal time (UTC) timestamp format as specified in <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339</a>
    - `lastUpdatedTime` string, date-time, required — The date and time the workflow was last updated, in coordinated universal time (UTC) timestamp format as specified in <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339</a>

## Other responses

- `480` — ThrottlingException
- `481` — ConflictException
- `482` — ValidationException
- `483` — ServiceQuotaExceededException
- `484` — ResourceNotFoundException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/codecatalyst.md) · [All operations](https://skmtc.net/aws/apis/codecatalyst/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/codecatalyst/versions/b82f5a10dc49/schema)