Genius Decision App Health API

openapi: 3.2.0
info:
  title: Genius Decision — agent integration Health API
  version: 0.2.0
  description: 'Genius bounded beta: HTTP agent integration subset. Public discovery; no-human-registration synthetic demo; automatic machine registration for synthetic/non-personal data; separate existing human-account keys. Machine Bearer keys are scoped, revocable and expire after 7 days (demo: 1 hour). Rotation only retains/reduces scopes. Human keys retain full account permissions. No MCP or OAuth. HTTP acceptance is distinct from formal admission and empirical evidence. Body limit 128 KiB; input limit 110000 JSON bytes. Declared choice profile: /static/decisions.html; explicit review and confirmation required. No general narrative solver or real-world CAG/PVS claim.'
servers:
- url: /
security:
- AccountBearer: []
tags:
- name: Health
paths:
  /api/health:
    get:
      operationId: getGeniusHealth
      summary: Read operational health
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  backup:
                    type: string
                  suspended:
                    type: boolean
                  mission_regulation:
                    type: object
                    required:
                    - protocol
                    - enabled
                    - mode
                    - observed_at
                    - scope
                    - policy_sha256
                    properties:
                      protocol:
                        const: genius-mission-regulation/1
                      enabled:
                        type: boolean
                      mode:
                        type: string
                        enum:
                        - DISABLED
                        - OBSERVING
                        - NORMAL
                        - DRAINING
                        - RESOURCE_PAUSED
                        - COOLDOWN
                        - PROBING
                        - SENSOR_PAUSED
                        - REVIEW_REQUIRED
                        - OBSERVATION_STALE
                      observed_at:
                        type:
                        - integer
                        - 'null'
                      scope:
                        const: QUEUED_ADAPTIVE_MISSIONS
                      policy_sha256:
                        type: string
                        pattern: ^[a-f0-9]{64}$
                required:
                - status
                - backup
                - suspended
        default:
          description: HTTP failure, not a motor result. 400 invalid input, 401 unauthorized, 403 origin/CSRF, 404 unavailable, 409 conflict/retry required, 413 size limit, 415 content type, 429 quota, 503 suspended/backup/storage unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security: []
      tags:
      - Health
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
          - code
          - message
      required:
      - error
  securitySchemes:
    AccountBearer:
      type: http
      scheme: bearer
      description: HTTPS Authorization Bearer only. ga_ machine credentials carry enforced scopes and expiry for their own isolated space. gb_ human-account API keys retain full-account access. Neither is a JWT. No key in a query string.
externalDocs:
  description: Full API contract and limitations
  url: https://geniusdecision.app/static/api.html
x-genius-mcp-available: true
x-genius-credential-scope:
  human: full-account
  automatic_agent: enforced-scopes-and-expiry
x-genius-client-safety:
  human_consent_never_inferred: true
  automatic_agent_data_policy: synthetic_or_non_personal_only
  synthetic_examples_are_not_empirical_evidence: true
  no_automatic_write_retries: true
x-genius-mcp:
  url: /mcp
  transport: streamable-http
  protocol_versions:
  - '2026-07-28'
  - '2025-11-25'
  - '2025-06-18'
  - '2025-03-26'
  public_tools:
  - get_capabilities
  - read_demo_result
  - run_demo
  private_authentication: scoped-machine-bearer-header
  oauth: false
x-genius-saved-demo:
  json: /static/demo-result.json
  html: /static/demo.html
  live_execution_on_get: false
  evidence_origin: synthetic