ProductionMu Mutation

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

taskId

TaskID!Required

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.

note

StringOptional

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)
TIMER

Started and stopped as a timer; the only kind that can be running

MANUAL

Logged by hand with a duration

COMPLETION

Logged 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.