---
title: "Refresh worker status"
method: POST
path: "/workers/{worker_id}/status"
---

# Refresh worker status

`POST /workers/{worker_id}/status`

Refreshes the heartbeat of the worker, and posts stats that can be used to determine overall
worker health. Workers that do not respond will not be kept track of after a timeout. If
dropped workers were running a job, this job will be restarted.

## Response `200`

succesfully updated worker's status

## Changes

- **2023-10-25** `6e568e568c76` — 1 info
  - endpoint added
- **2020-09-05** `87cae065c674` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/changes/workers/:worker_id/status/post.md)

---

[API](https://skmtc.dev/osbuild/apis/osbuild-composer-worker.md) · [All operations](https://skmtc.dev/osbuild/apis/osbuild-composer-worker/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/osbuild/osbuild-composer-worker/revisions/f6de32b9b1a1/schema)