Skip to content
Leadtime
English
Esc
↑↓navigate↵open⌘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
200

Task skip from billing flag set successfully

successbooleanrequired

Operation success flag

401

Unauthorized - Invalid or missing authentication token

403

User lacks Invoices.manage permission or project access

404

Potential invoice or task not found

Try it
Server
Authorization
Parameters
Bodyapplication/json
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
}