---
title: "Update a check run (self-hosted)"
method: PATCH
path: "/self-hosted/{accountId}/workspaces/{workspaceId}/tasks/{taskId}/check-run"
tags: ["Self-Hosted Runners"]
---

# Update a check run (self-hosted)

`PATCH /self-hosted/{accountId}/workspaces/{workspaceId}/tasks/{taskId}/check-run`

Updates the status of a VCS check run for a task (self-hosted)

## Path parameters

- `accountId` string, required
- `workspaceId` string, required
- `taskId` string, required

## Request body

- UpdateCheckRunRequest
  - `checkRunId` string, required
  - `commitId` string, required — Commit identifier
  - `update` 'queued' | 'in_progress' | 'success' | 'failure' | 'blocked', required
  - `gitlab` GitLabCheckRunUpdate
    - `projectId` integer — Project identifier
    - `prId` integer — Merge request ID if applicable
    - `headSha` string — Head SHA of the commit

## Response `200`

Check run updated successfully

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Insufficient permissions
- `404` — Not Found Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)