Delete manual position category
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
idparameter 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.
DELETE
/workspace/manual-position-categories/{id}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredResponses
200
successbooleanrequiredOperation success flag
401
Unauthorized - Invalid or missing authentication token
403
Forbidden - Insufficient API scopes or permissions