Update manual position in potential invoice
What does this do? Updates an existing custom manual position in a potential invoice. You can modify the title and/or price of the position.
When to use:
- To correct the title or price of a manual position
- To adjust pricing before finalizing the invoice
- To update position details after initial creation
How it works:
- Updates the manual position stored in the potential invoice metadata
- Only custom manual positions (type: manual) can be updated
- Project manual positions (from project snapshots) are read-only and cannot be modified
- Both title and price must be provided (even if only one is changing)
Position requirements:
- Position must exist in the potential invoice
- Position must be a custom manual position (not a project position)
- Title and price are required
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.
/billing/potential-invoices/{id}/manual-positions/{positionId}AuthorizationOAuth2 access token · headerrequiredapi:writeAuthorizationBearer token (JWT) · headerrequiredidstringrequiredPotential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}
positionIdstring<uuid>requiredManual position ID (UUID) to update
application/jsonpricenumberrequiredNet price (before tax) for this manual position in the workspace currency
titlestringrequiredTitle or description of the manual position
Manual position updated successfully
successbooleanrequiredOperation success flag
Unauthorized - Invalid or missing authentication token
User lacks Invoices.manage permission or project access
Potential invoice or manual position not found