Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

DELETE/v1/workers/{worker_id}

Delete Worker

Remove a registered worker. Frees up the worker_id slot for re-registration.

Removes a registered worker. Use this when retiring a machine or re-running the cueapi-worker daemon under a fresh worker_id.

Returns 204 No Content on success.

Request

bash

curl -X DELETE https://api.cueapi.ai/v1/workers/agent-mac-01 \
  -H "Authorization: Bearer cue_sk_YOUR_KEY"

Response

text

(empty body)

Behavior

The worker row is hard-deleted from workers.
Any active claims held by this worker are released — the executions return to claimable state and the next available worker picks them up.
The worker_id slot is free for re-registration immediately.
This does not affect cues. Worker-transport cues that previously routed to this worker continue to be queued for any matching worker.

Errors

Status	Code	Cause
401	`not_authenticated`	Missing/invalid bearer token
404	`worker_not_found`	`worker_id` doesn't exist or doesn't belong to the authenticated user

Scoped key behavior

If your API key is scoped (e.g., restricted_to_workers), you can only delete workers registered under that key or sibling keys. Default keys can delete any worker on the account.

DELETE/v1/workers/{worker_id}

Try it

Replace path parameters (e.g. {cue_id}) in the URL before sending.

Enter your API key above to send requests

Previous← List Workers NextStore Payload →