← API reference
CANONICAL TYPE REFERENCE

StatusEvent

A committed lifecycle status transition delivered via subscription

entityTypeString!

Entity kind (JOB, ORDER, OPERATION, SHIPMENT, COMPONENT, or custom)

entityIdString!

The transitioning entity's id, as a TypeID (e.g. "job_01K…").

fromStateString

Previous state (null on the entity's first transition)

toStateString!

New state

actorTypeString!

Immediate principal kind

actorIdString

The acting principal, as a UserID TypeID (e.g. "usr_01K…"). Always a user, even when actorType is SYSTEM — a bot user is classified SYSTEM but still acts as its own user record. Null for a transition with no principal.

userIdString

Responsible human, when known, as a UserID TypeID.

Ingest/UI surface the transition arrived through

originIdString

Id of the origin surface. Always null today: the origin surface is not yet populated on the write path, so no transition carries one.

occurredAtString!

ISO8601 business time of the transition

reasonString

Free-text justification supplied by the caller, when given.

View exact SDL
"""A committed lifecycle status transition delivered via subscription"""
type StatusEvent {
  """Entity kind (JOB, ORDER, OPERATION, SHIPMENT, COMPONENT, or custom)"""
  entityType: String!
  """The transitioning entity's id, as a TypeID (e.g. "job_01K…")."""
  entityId: String!
  """Previous state (null on the entity's first transition)"""
  fromState: String
  """New state"""
  toState: String!
  """Immediate principal kind"""
  actorType: String!
  """
  The acting principal, as a UserID TypeID (e.g. "usr_01K…"). Always a user, even when actorType is SYSTEM — a bot user is classified SYSTEM but still acts as its own user record. Null for a transition with no principal.
  """
  actorId: String
  """Responsible human, when known, as a UserID TypeID."""
  userId: String
  """Ingest/UI surface the transition arrived through"""
  originType: String
  """
  Id of the origin surface. Always null today: the origin surface is not yet populated on the write path, so no transition carries one.
  """
  originId: String
  """ISO8601 business time of the transition"""
  occurredAt: String!
  """Free-text justification supplied by the caller, when given."""
  reason: String
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.