Update timesheet status
update_timesheet_statusDestructive
Moves the monthly timesheet of an employee through its status workflow: Complete, Validate, Close or Unlock. This performs a real, destructive write - use deliberately, and never assume the month. Each transition is allowed from one status only, so read the current status with get_timesheet first. Read get_documentation('timesheet_status_workflow') before calling: it carries the transitions, the error codes and the rules on comments and feedback levels.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Year of the period to act on, e.g. 2026. | |
| month | Yes | Month of the period to act on, from 1 to 12. | |
| action | Yes | Transition to apply: Complete, Validate, Close or Unlock. | |
| comment | No | Complete only. End of month comment recorded with the feedback. Optional, but omitting it erases the comment already recorded for the period. | |
| employeeId | No | Identifier of the employee. Defaults to the authenticated user. | |
| learningLevel | No | Complete only. Self assessed learning level, from 1 to 4. Optional. | |
| wellBeingLevel | No | Complete only. Self assessed well being level, from 1 to 4. Optional. | |
| communicationLevel | No | Complete only. Self assessed communication level, from 1 to 4. Optional. | |
| customerRelationshipLevel | No | Complete only. Self assessed customer relationship level, from 1 to 4. Optional. |