← All types
ProductionOb Object

TaskTimeEntry

A stretch of work on a task by the person who logged it. Entries are never edited or deleted once finished: a correction voids the entry and logs a new one.

Fields

Unique identifier

taskId

TaskID!Non-null

The task the time was spent on

userId

UserID!Non-null

The person who logged the time; the entry is theirs

Display name of the person who logged the time, falling back to their email; null when the user no longer exists

How the entry was recorded

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

When the work started (ISO8601)

When the work ended (ISO8601); null while a timer runs and for a discarded timer

Seconds between start and end, computed by the server from the two instants; null while a timer runs and for a discarded timer

True while this is a running timer: no end and not voided

note

StringNullable

What the time was spent on, as the logger wrote it

voided

Boolean!Non-null

True once the entry was voided or, as a running timer, discarded. A voided entry stays on record but counts toward no total.

When the entry was voided (ISO8601); null unless voided

Who voided the entry; null unless voided

Why the entry was voided; null for a discarded timer and unless voided

The recorded cost this entry booked on the task's job, when it was costed; null otherwise

The recorded cost that reversed this entry's cost when it was voided; null otherwise

When the entry was recorded (ISO8601)

The task the time was spent on, when the caller may read it; null otherwise. Meant for a single entry such as myRunningTimer, not long lists: it reads the task per entry.

Referenced by (4)
Exact type SDL
"""
A stretch of work on a task by the person who logged it. Entries are never edited or deleted once finished: a correction voids the entry and logs a new one.
"""
type TaskTimeEntry {
  """Unique identifier"""
  id: TaskTimeEntryID!
  """The task the time was spent on"""
  taskId: TaskID!
  """The person who logged the time; the entry is theirs"""
  userId: UserID!
  """
  Display name of the person who logged the time, falling back to their email; null when the user no longer exists
  """
  userName: String
  """How the entry was recorded"""
  source: TaskTimeEntrySource!
  """When the work started (ISO8601)"""
  startedAt: ISO8601!
  """
  When the work ended (ISO8601); null while a timer runs and for a discarded timer
  """
  endedAt: ISO8601
  """
  Seconds between start and end, computed by the server from the two instants; null while a timer runs and for a discarded timer
  """
  durationSeconds: Int
  """True while this is a running timer: no end and not voided"""
  running: Boolean!
  """What the time was spent on, as the logger wrote it"""
  note: String
  """
  True once the entry was voided or, as a running timer, discarded. A voided entry stays on record but counts toward no total.
  """
  voided: Boolean!
  """When the entry was voided (ISO8601); null unless voided"""
  voidedAt: ISO8601
  """Who voided the entry; null unless voided"""
  voidedBy: UserID
  """Why the entry was voided; null for a discarded timer and unless voided"""
  voidReason: String
  """
  The recorded cost this entry booked on the task's job, when it was costed; null otherwise
  """
  recordedCostId: RecordedCostID
  """
  The recorded cost that reversed this entry's cost when it was voided; null otherwise
  """
  reversalCostId: RecordedCostID
  """When the entry was recorded (ISO8601)"""
  createdAt: ISO8601!
  """
  The task the time was spent on, when the caller may read it; null otherwise. Meant for a single entry such as myRunningTimer, not long lists: it reads the task per entry.
  """
  task: TaskState
}