← API reference
Subscription / jobs

statusEvents

Subscribe to committed status transitions. Requires read permission on each requested entity type.

Arguments

entityTypes[String!]!

Entity types to watch, e.g. ["ORDER", "JOB"]. Requires read on each.

entityIdString

Optional single-entity filter, as a TypeID (e.g. "job_01K…").

toStateString

Optional target-state filter, e.g. "DELIVERED".

Returns StatusEvent!

Scalar fields at a glance

entityTypeString!
entityIdString!
fromStateString
toStateString!
actorTypeString!
actorIdString
↗ View the complete StatusEvent type

Explore in a view

Production Floor
View exact SDL
"""
Subscribe to committed status transitions. Requires read permission on each requested entity type.
"""
statusEvents(
  """Entity types to watch, e.g. ["ORDER", "JOB"]. Requires read on each."""
  entityTypes: [String!]!
  """Optional single-entity filter, as a TypeID (e.g. "job_01K…")."""
  entityId: String
  """Optional target-state filter, e.g. "DELIVERED"."""
  toState: String
): StatusEvent! @topic(names: ["jobs"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.