Skip to main content
The monthly PTO report tracks, per user and per month, the hours expected, the hours worked, the PTO earned and used, the balance carried from the previous month, and any resulting salary deduction.
Sample responses on this page show the JSON envelope (--json). Pretty output is the default on a terminal and its columns adapt to width. See Output formats.

monthly-ptos list

Read the report for a month. Omit --user-email for the whole organization.

monthly-ptos update-earned

Set PTO earned for one or more users in a month. --email is repeatable. Pass --pto-earned 0, or omit the flag, to clear earned PTO.
The response reports each email separately, so a bad address in the list does not fail the whole run.
Reading the report and changing it are separate permissions. An account that can view monthly PTO may still be refused update-earned.