logTaskTime
Topics: Jobs
Log time spent on a task by hand. The assignee, the claimer, a member of the assigned team while unclaimed, or a task:write holder.
Returns
TaskTimeEntryPayload!Arguments
The task the time was spent on: open, or finished (completed, rejected or cancelled) within the last 30 days
How long the work took, in seconds: 60 (1 minute) to 86400 (24 hours)
When the work ended (ISO8601); defaults to now. Up to 60 seconds ahead of the server is taken as now; further ahead is refused.
Optional note on what the time was spent on, up to 2000 characters
How the time is recorded: MANUAL (the default) for a log by hand, COMPLETION for time logged when the task is marked done. TIMER is refused: only the timer records it. COMPLETION is refused with TIMER_RUNNING while the caller's timer runs on the task, since completing stops and costs that timer, and with COMPLETION_ALREADY_LOGGED when the caller already has a live COMPLETION entry on the task, open or finished (void it to log again).
Possible values (3)
TIMERStarted and stopped as a timer; the only kind that can be running
MANUALLogged by hand with a duration
COMPLETIONLogged with a duration when the task was marked done
Exact field SDL
"""
Log time spent on a task by hand. The assignee, the claimer, a member of the assigned team while unclaimed, or a task:write holder.
"""
logTaskTime(
"""
The task the time was spent on: open, or finished (completed, rejected or cancelled) within the last 30 days
"""
taskId: TaskID!
"""How long the work took, in seconds: 60 (1 minute) to 86400 (24 hours)"""
durationSeconds: Int!
"""
When the work ended (ISO8601); defaults to now. Up to 60 seconds ahead of the server is taken as now; further ahead is refused.
"""
endedAt: ISO8601
"""Optional note on what the time was spent on, up to 2000 characters"""
note: String
"""
How the time is recorded: MANUAL (the default) for a log by hand, COMPLETION for time logged when the task is marked done. TIMER is refused: only the timer records it. COMPLETION is refused with TIMER_RUNNING while the caller's timer runs on the task, since completing stops and costs that timer, and with COMPLETION_ALREADY_LOGGED when the caller already has a live COMPLETION entry on the task, open or finished (void it to log again).
"""
source: TaskTimeEntrySource
): TaskTimeEntryPayload! @topic(names: ["jobs"])Declared on Mutation. Access is checked by the platform for each operation.