API Reference

Workers

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete a worker template

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.

Path ParametersExpand Collapse

workerId: string

ReturnsExpand Collapse

DeleteWorkerResponse object { deleted }

deleted: boolean

Delete a worker template

HTTP

HTTP

TypeScript

Python

Go

Ruby

CLI Tool

curl https://handinger.com/api/workers/$WORKER_ID \
    -X DELETE \
    -H "Authorization: Bearer $HANDINGER_API_KEY"

200 example

{
  "deleted": true
}

Returns Examples

200 example

{
  "deleted": true
}