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
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X DELETE "https://leadtime.app/api/public/workspace/manual-position-categories/string" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/workspace/manual-position-categories/string", {
method: "DELETE",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.delete(
"https://leadtime.app/api/public/workspace/manual-position-categories/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"success": true
}Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions