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 · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredPotential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}
positionIdstring<uuid>requiredManual position ID (UUID) to delete
Responses
200Manual position deleted successfully
successbooleanrequiredOperation 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"const response = await fetch("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", {
method: "DELETE",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.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",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"success": true
}Unauthorized - Invalid or missing authentication token
User lacks Invoices.manage permission or project access
Potential invoice or manual position not found