RuntimeFlagSetting

A runtime switch, changeable without a deploy: the AI kill-switch hierarchy (key ai.kill) and the per-capability rollout flags (ai.background_turns, ai.missions, ...). A change reaches every API pod within the flag TTL.

type RuntimeFlagSetting {
  key: String!
  scope: RuntimeFlagScope!
  target: String!
  state: RuntimeFlagState!
  cohort: [String!]!
  reason: String
  updatedBy: String
  updatedAt: Time!
}

Fields

RuntimeFlagSetting.key ● String! non-null scalar

RuntimeFlagSetting.scope ● RuntimeFlagScope! non-null enum

RuntimeFlagSetting.target ● String! non-null scalar

Model id, provider, org alias or Mission id; empty for GLOBAL.

RuntimeFlagSetting.state ● RuntimeFlagState! non-null enum

RuntimeFlagSetting.cohort ● [String!]! non-null scalar

RuntimeFlagSetting.reason ● String scalar

RuntimeFlagSetting.updatedBy ● String scalar

Staff member (JWT sub), or 'breaker' when the spend breaker set it.

RuntimeFlagSetting.updatedAt ● Time! non-null scalar

Returned By

runtimeFlags query ● setRuntimeFlag mutation