Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

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

DELETE/workspace/manual-position-categories/{id}
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
idstringrequired
Responses
200
successbooleanrequired
Operation 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"
Response
{
  "success": true
}