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.
/billing/potential-invoices/{id}/tasks/{taskId}/skip-from-billingAuthorizationOAuth2 access token · headerrequiredapi:writeAuthorizationBearer token (JWT) · headerrequiredidstringrequiredPotential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}
taskIdstring<uuid>requiredTask ID (UUID) to set skip from billing flag for
application/jsonskipFromBillingbooleanrequiredWhether to skip this task from billing. Set to true to exclude the task from the invoice, or false to include it again.
Task skip from billing flag set successfully
successbooleanrequiredOperation success flag
Unauthorized - Invalid or missing authentication token
User lacks Invoices.manage permission or project access
Potential invoice or task not found