---
search:
  tags:
    - workspace
    - DELETE
seo:
  description: >-
    Soft deletes a manual position category by… Reference for the DELETE
    /workspace/manual-position-categories/{id} endpoint in the Leadtime Public
    API API.
sidebar:
  badge: DELETE
  label: Delete manual position category
title: Delete manual position category
type: openapi-operation
---
Soft deletes a manual position category by setting its `deletedAt` timestamp. All manual positions that were assigned to this category will have their `categoryId` automatically unset to `null`.

**How it works:**
- The category is marked as deleted (soft delete) and will no longer appear in category lists
- All manual positions that were using this category are automatically updated to have `categoryId = null`
- Manual positions themselves are not deleted, only their category assignment is removed
- The category cannot be recovered after deletion

**What is returned:**
- `success`: Boolean indicating the operation completed successfully

**Error handling:**
- If the category ID doesn't exist, returns `404 Not Found`
- The `id` parameter must be a valid UUID

**Use cases:**
- Removing obsolete categories that are no longer needed
- Consolidating categories by removing duplicates
- Cleaning up workspace organization

**Note:** This endpoint requires the `manageManualPositions` permission.

<Operation source="api-reference" id="manualpositioncategoriescontroller-deletecategory" />