ManagedAiBalanceResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/everyn-ai/json-schema/everyn-ai-managed-ai-balance-response-schema.json",
  "title": "ManagedAiBalanceResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/everyn-ai-usage-api-openapi.yml#/components/schemas/ManagedAiBalanceResponse",
  "additionalProperties": false,
  "properties": {
    "calculatedAt": {
      "format": "date-time",
      "title": "Calculatedat",
      "type": "string"
    },
    "executionSafe": {
      "anyOf": [
        {
          "$ref": "#/$defs/CustomerMoneyResponse"
        },
        {
          "type": "null"
        }
      ],
      "description": "Execution-safe managed-AI balance at calculatedAt: the value runtime admission would fund new work against, net of open per-action holds. Advisory, not a reservation. Settlement drains the wallet asynchronously after rows complete, so recently finished work may not be reflected yet, and concurrent runs can still exhaust the wallet mid-run. Model-agnostic: admission reserves a per-turn bound that varies by model, so a small positive balance may still be denied as insufficient for a single turn of an expensive model. A run that outspends the wallet pauses with resumeAvailable rather than losing work, its unfunded rows failing as billing.wallet_admission_denied (agent-query runs pause with reason cached_balance_exhausted). Null when no balance can be stated — the organization has never been granted managed-AI value, or its ledger could not currently be read; spendingAllowed is false in both cases, while a drained wallet reads \"0.00\"."
    },
    "spendingAllowed": {
      "description": "Whether the organization's billing state permits new paid work. False while a financial hold, an unpaid-invoice suspension, or missing paid-period authority stands against the account, regardless of remaining balance. Create, start, and resume refuse those same states; treat false as do-not-start-paid-work. A watcher already draining a running run may still send until its pause-cache snapshot re-reads zero.",
      "title": "Spendingallowed",
      "type": "boolean"
    },
    "status": {
      "enum": [
        "available",
        "low",
        "unavailable"
      ],
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "calculatedAt",
    "spendingAllowed",
    "executionSafe",
    "status"
  ],
  "type": "object",
  "$defs": {
    "CustomerMoneyResponse": {
      "additionalProperties": false,
      "properties": {
        "amount": {
          "description": "Exact base-10 amount serialized without binary floating point or exponent notation.",
          "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
          "title": "Amount",
          "type": "string"
        },
        "currencyCode": {
          "maxLength": 3,
          "minLength": 3,
          "title": "Currencycode",
          "type": "string"
        }
      },
      "required": [
        "currencyCode",
        "amount"
      ],
      "title": "CustomerMoneyResponse",
      "type": "object"
    }
  }
}