Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

Set task skip from billing flag

What does this do? Sets the skipFromBilling flag on a task, which permanently marks the task as excluded from billing. Unlike toggling skipped status (which only affects the current invoice), this flag prevents the task from appearing in any future potential invoices.

When to use:

  • To permanently exclude a task from billing (e.g., internal work, non-billable tasks)
  • To mark tasks that should never be invoiced
  • To undo a previous “skip from billing” decision (set to false)

How it works:

  • Updates the task.skipFromBilling field directly on the task
  • When set to true, the task will not appear in any potential invoices
  • When set to false, the task can be included in invoices again
  • This is different from toggling skipped status, which only affects the current invoice metadata

Task requirements:

  • Task must belong to the potential invoice’s project
  • Task must not be already billed (billed: false)
  • User must have access to the project

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.

POST/billing/potential-invoices/{id}/tasks/{taskId}/skip-from-billing
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}
taskIdstring<uuid>required
Task ID (UUID) to set skip from billing flag for
Request body
requiredapplication/json
skipFromBillingbooleanrequired
Whether to skip this task from billing. Set to true to exclude the task from the invoice, or false to include it again.
Responses
200Task skip from billing flag set successfully
successbooleanrequired
Operation success flag
401Unauthorized - Invalid or missing authentication token
403User lacks Invoices.manage permission or project access
404Potential invoice or task not found
Request
curl -X POST "https://leadtime.app/api/public/billing/potential-invoices/SingleProject%3A%3A0e9d033a-ab41-4212-8637-66c4e3b01fe2%3A%3A2025-10-01%3A%3A2025-10-31/tasks/550e8400-e29b-41d4-a716-446655440000/skip-from-billing" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "skipFromBilling": true
}'
Response
{
  "success": true
}