API Reference

Workers

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete a worker template

$ handinger workers delete

DELETE/api/workers/{workerId}

Soft-delete a worker template so it no longer appears in list or retrieve endpoints. Tasks, turns, files, schedules, and integrations remain in the database for analytics. Only the worker creator can delete a worker.

ParametersExpand Collapse

--worker-id: string

Worker id returned by the create worker endpoint.

ReturnsExpand Collapse

delete_worker_response: object { deleted }

deleted: boolean

Delete a worker template

CLI Tool

HTTP

TypeScript

Python

Go

Ruby

CLI Tool

handinger workers delete \
  --api-key 'My API Key' \
  --worker-id t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM

200 example

{
  "deleted": true
}

Returns Examples

200 example

{
  "deleted": true
}