Skip to main content

PlayerAutomation

A player-owned automation confined to one app and grid. Trigger/action JSON has been structurally validated.

type PlayerAutomation {
  automationId: String!
  appId: BigInt!
  gridId: BigInt!
  ownerUserId: BigInt!
  name: String!
  description: String
  enabled: Boolean!
  triggerJson: String!
  actionJson: String!
  maxRunsPerMinute: Int!
  failureThreshold: Int!
  cooldownMs: Int!
  circuitState: String!
  consecutiveFailures: Int!
  pausedUntil: DateTime
  lastError: String
  lastRunAt: DateTime
  nextRunAt: DateTime
  createdAt: DateTime!
  updatedAt: DateTime!
}

Fields

`PlayerAutomation.automationId` ● `String!` non-null scalar

Player automation UUID.

`PlayerAutomation.appId` ● `BigInt!` non-null scalar

App containing the automation.

`PlayerAutomation.gridId` ● `BigInt!` non-null scalar

Grid confining the automation.

`PlayerAutomation.ownerUserId` ● `BigInt!` non-null scalar

Owning user. Forced from current grid ownership at creation.

`PlayerAutomation.name` ● `String!` non-null scalar

Owner-local automation name.

`PlayerAutomation.description` ● `String` scalar

Optional description.

`PlayerAutomation.enabled` ● `Boolean!` non-null scalar

Whether the automation may dispatch.

`PlayerAutomation.triggerJson` ● `String!` non-null scalar

Validated trigger as canonical JSON.

`PlayerAutomation.actionJson` ● `String!` non-null scalar

Validated action as canonical JSON.

`PlayerAutomation.maxRunsPerMinute` ● `Int!` non-null scalar

Maximum runs per rolling minute.

`PlayerAutomation.failureThreshold` ● `Int!` non-null scalar

Failures required to open the circuit.

`PlayerAutomation.cooldownMs` ● `Int!` non-null scalar

Open-circuit cooldown in milliseconds.

`PlayerAutomation.circuitState` ● `String!` non-null scalar

Circuit state: closed, open, or half_open.

`PlayerAutomation.consecutiveFailures` ● `Int!` non-null scalar

Current consecutive failure count.

`PlayerAutomation.pausedUntil` ● `DateTime` scalar

Time at which an open circuit may retry.

`PlayerAutomation.lastError` ● `String` scalar

Most recent dispatch error.

`PlayerAutomation.lastRunAt` ● `DateTime` scalar

Most recent dispatch time.

`PlayerAutomation.nextRunAt` ● `DateTime` scalar

Next scheduled dispatch time.

`PlayerAutomation.createdAt` ● `DateTime!` non-null scalar

Automation creation time.

`PlayerAutomation.updatedAt` ● `DateTime!` non-null scalar

Most recent automation update time.

Returned By

playerAutomationCreate mutation ● playerAutomations query ● playerAutomationSetEnabled mutation

Fields
Returned By