---
title: "Update Run status"
method: PATCH
path: "/runs/{runId}"
---

# Update Run status

`PATCH /runs/{runId}`

Update the status of a Run.

## Path parameters

- `runId` string, required

## Request body

- object
  - `status` 'pending' | 'awaiting_execution' | 'running_execution' | 'awaiting_scoring' | 'running_scoring' | 'awaiting_human_scoring' | 'completed', required — The status of the Run.

## Response `200`

Run updated successfully

- object
  - `id` string, required — The ID of the Run.
  - `status` 'pending' | 'awaiting_execution' | 'running_execution' | 'awaiting_scoring' | 'running_scoring' | 'awaiting_human_scoring' | 'completed', required — The status of the Run.

## Other responses

- `401` — Error indicating that the request is not authenticated.
- `500` — An internal service error indicating an issue with the Scorecard service.

## Changes

- **2025-04-28** `e3159f1f21c4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/runs/:runId/patch.md)

---

[API](https://skmtc.dev/scorecard-ai/apis/scorecard-api.md) · [All operations](https://skmtc.dev/scorecard-ai/apis/scorecard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scorecard-ai/scorecard-api/revisions/bd35baa083a2/schema)