log_time_entry
Log actual worked hours on a task for a user and date, choosing add to increase or set to replace the stored total.
Instructions
Log actual worked hours on a task for one user and date. ITM Platform stores ONE total per user+task+date: mode "add" adds to it, "set" replaces it (0:00 clears). The response echoes the previous and new totals. The user must be assigned to the task (TaskMembers on update_task) and the project status must allow time entry (closed projects block it). userId defaults to the session user; another user requires a Company Admin or Full Access license and the hours are attributed to that user.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"taskId": "<taskId>",
"date": "<date>",
"hours": "<hours>",
"mode": "<mode>"
},
"name": "log_time_entry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Work date (YYYY-MM-DD); not in the future | |
| mode | Yes | "add" adds to the existing total; "set" replaces it | |
| hours | Yes | Whole hours worked | |
| taskId | Yes | Task ID to log time on | |
| userId | No | User to log time for (default: session user) | |
| comment | No | Comment stored on the day's entry | |
| minutes | No | Minutes worked, 0-59 (default 0) | |
| projectId | Yes | Project ID containing the task |