Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

Delete manual position from potential invoice

What does this do? Removes a custom manual position from a potential invoice. The position is permanently removed from the invoice and will no longer appear in the invoice preview or be included in calculations.

When to use:

  • To remove a manual position that was added by mistake
  • To remove a position that is no longer needed
  • To clean up the invoice before finalizing

How it works:

  • Removes the manual position from the potential invoice metadata
  • Only custom manual positions (type: manual) can be deleted
  • Project manual positions (from project snapshots) are read-only and cannot be deleted
  • The position is immediately removed from the invoice preview

Position requirements:

  • Position must exist in the potential invoice
  • Position must be a custom manual position (not a project position)

Invoice ID Format: The invoice ID follows the format: {type}::{projectId}::{dateFrom}::{dateTo}

  • Example: SingleProject::0e9d033a-ab41-4212-8637-66c4e3b01fe2::2025-10-01::2025-10-31

Permission requirements: Requires Invoices.manage permission and access to the project.

DELETE/billing/potential-invoices/{id}/manual-positions/{positionId}
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
idstringrequired
Potential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}
positionIdstring<uuid>required
Manual position ID (UUID) to delete
Responses
200Manual position deleted successfully
successbooleanrequired
Operation success flag
401Unauthorized - Invalid or missing authentication token
403User lacks Invoices.manage permission or project access
404Potential invoice or manual position not found
Request
curl -X DELETE "https://leadtime.app/api/public/billing/potential-invoices/SingleProject%3A%3A0e9d033a-ab41-4212-8637-66c4e3b01fe2%3A%3A2025-10-01%3A%3A2025-10-31/manual-positions/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
  "success": true
}