Genius Decision App Examples API

openapi: 3.2.0
info:
  title: Genius Decision — agent integration Examples 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: Examples
paths:
  /api/examples/{name}:
    get:
      operationId: getGeniusExample
      summary: Read a synthetic profile example
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
        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: []
      parameters:
      - name: name
        in: path
        required: true
        schema:
          enum:
          - hours-known
          - hours-unknown
          - fdq-frontier
          - fdq-selector
          - choice-leisure
      description: The response has profile at top level. For POST /api/cases extract profile and use the remaining example fields as input. Do not infer human permissions for real data from examples.
      tags:
      - Examples
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