Timesheets API

A timesheet is one person's week of time on one project, Monday to Sunday: the Monday it starts on, the minutes it holds with the billable minutes among them, the count of logs, and where it stands. A week is open while its logs still change, awaiting approval from the moment it is put to the project's approvers (its logs hold until they answer or the week is withdrawn), and approved once they approve it, which locks every log of the week and counts it for billing. An approver may reopen an approved week, which unlocks its logs, and the week waits to be put forward again.

The approval itself runs through the approvals endpoints like every other gate: the submission here opens the request, the approvers decide it with POST /v1/approvals/{approval}/decide, and the person who put the week forward withdraws it with POST /v1/approvals/{approval}/withdraw. Who approves comes from the project's Timesheet approval policy, the project manager by default.

Every read here is the team's; a client guest's token is refused with 403. A week is read by its owner, or by anyone who may see the project's time; it is put forward by its owner, or for them by someone who may approve time on the project.

EndpointsCopy Anchor Link

Related

Time Logs APIThe logs a week holds, locked once it is approved.Approvals APIDeciding and withdrawing the request a week is under.timesheet.* eventsThe life of a member's week of time on a project: put to its approver, approved and locked, reopened, and a version put back.