---
title: "Remove Worker"
method: DELETE
path: "/worker/{worker_id}"
tags: ["workers"]
---

# Remove Worker

`DELETE /worker/{worker_id}`

Terminally stop a worker.

Same auth chain as deploy. The worker is resolved org-scoped, so a guessed
id from another organization 404s rather than stopping it.

## Path parameters

- `worker_id` string, required

## Response `200`

Successful Response

- RemoveWorkerResponse — Outcome of removing a worker. ``already_stopped`` distinguishes a no-op from a stop this call issued, so the UI can stay quiet instead of claiming it stopped something that was already stopped (or was never deployed).
  - `worker_id` string, required
  - `already_stopped` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)