## 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.

### Parameters

- `--worker-id: string`

  Worker id returned by the create worker endpoint.

### Returns

- `delete_worker_response: object { deleted }`

  - `deleted: boolean`

### Example

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

#### Response

```json
{
  "deleted": true
}
```