v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB
Timesheets

Approve Week/Request for Approval

Submit a timesheet week for approval.

The week's owner uses this endpoint to request review; an approver acts on the request via PUT /timesheets/{timesheet_id}/approval.

The timesheet_id is the concatenation of user_id and a 4-digit week_id in YYWW format (no separator). Example: user 14856 for week 2535 (week 35 of 2025) → timesheet_id = 148562535. See the Timesheets overview for the full Week ID definition.

post/timesheets/{timesheet_id}/approval

Path parameters

timesheet_idnumber required
Example:148562535

Timesheet ID

Request body

commentstring
reviewernumber

User ID, must be admin in team

sendNotificationboolean

Example request

{
  "comment": "some text",
  "reviewer": 14854
}

Response

OK

idnumber

Timesheet ID

usernumber

User ID

weekIdnumber
reviewernumber

Reviewer User ID

status'pending' | 'rejected' | 'approved' | 'partial_approved' | 'discarded'
totalTimeinteger nullable

Total approved time in seconds.

Example response

{
  "id": 148562535,
  "user": 14856,
  "weekId": 2535,
  "reviewer": 14854,
  "history": [
    {
      "action": "submitted",
      "days": {
        "monday": true,
        "tuesday": true,
        "wednesday": true,
        "thursday": true,
        "friday": true
      },
      "user": 2535,
      "comment": "some text",
      "createdAt": "2025-08-05 16:17:14"
    }
  ]
}