# DELETE /api/v2/work-types/{work_type}

Delete a work type

- MCP id: work-types.destroy
- Scope: api:destroy:work_types
- Permission: work_types::delete
- Needs the sprints feature on your organisation
- Rate cost: 1 unit, write bucket.
- Cache-Control: private, no-store

Permanently deletes a work-item type.

This resource is hard-delete: there is no restore action, no `force` parameter and no `trashed` parameter. A type that is still used by work items cannot be deleted: it answers `403` `forbidden-by-policy`, or `404` `resource-not-found` when your token does not also carry `work_types::read`, because a refusal naming a specific id must not confirm that id to a caller who cannot read the collection. Without that refusal, deleting the type would also delete every work item of that type together with its comments, subtasks, links and attachments. Retype the affected work items first, then delete.

## Parameters
- work_type (integer, path): The WorkType's numeric id.
- X-Request-Id (header, optional): A correlation id of your own. It is recorded in our logs next to the server's request id but never returned: the response header always carries the server's id. A value that does not match the pattern is discarded silently, never rejected.
- If-Match (header, optional): The ETag a write is conditional on. A stale validator is 412 precondition-failed.

## Response 204

## Errors
- 403 forbidden-by-policy | insufficient-permission | insufficient-token-scope: Forbidden.
  - `forbidden-by-policy`: Work items still use this type. Move them to another type first: deleting the type would also delete them, with their comments, subtasks, links and attachments.
- 412 precondition-failed: Precondition failed.
- 400 idempotency-key-required | invalid-cursor | invalid-query-parameter | malformed-request | unsupported-parameter: Bad request.
- 401 token-expired | unauthenticated: Unauthenticated.
- 404 endpoint-not-found | resource-not-found: Not found.
- 406 not-acceptable: Not acceptable.
- 429 rate-limit-exceeded: Too many requests.
- 500 internal-error: Server error.
- 503 tenant-unavailable: Service unavailable.

## Example
```bash
curl -X DELETE \
  'https://<your-url>/api/v2/work-types/1' \
  -H 'Authorization: Bearer <token>' \
  -H 'Accept: application/json'
```