Casa Intelligence Ops API

openapi: 3.2.0
info:
  title: Casa Intelligence Engine Ops API
  description: Proprietary data ingestion, analysis, and prediction engine for Queensland property development intelligence.
  version: 2.0.0
tags:
- name: ops
paths:
  /api/v1/ops/projects/{project_id}/events:
    get:
      tags:
      - ops
      summary: List Project Events
      description: Full append-only event history for one project, newest first. Founder-only.
      operationId: list_project_events_api_v1_ops_projects__project_id__events_get
      security:
      - HTTPBearer: []
      parameters:
      - name: project_id
        in: path
        required: true
        schema:
          type: string
          title: Project Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 2000
          minimum: 1
          default: 500
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Project Events Api V1 Ops Projects  Project Id  Events Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/ops/events:
    get:
      tags:
      - ops
      summary: Search Events
      description: 'Cross-project event search by customer / step / status. Founder-only.


        Powers Claude''s "has X happened for this customer?" via the ops endpoint

        (the direct-SQL path is the Supabase connector; this is the HTTP twin).'
      operationId: search_events_api_v1_ops_events_get
      security:
      - HTTPBearer: []
      parameters:
      - name: customer_email
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Customer Email
      - name: step_key
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Step Key
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 2000
          minimum: 1
          default: 500
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Search Events Api V1 Ops Events Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/ops/projects/{project_id}/steps/{step_key}/run:
    post:
      tags:
      - ops
      summary: Rerun Step
      description: 'Idempotently re-trigger a step. Founder-only (one-click recovery).


        * If a step fn is registered for ``step_key`` (e.g. by WS1), it is re-run

        via :func:`run_step` (honouring idempotency unless ``force=True``) and the

        result is returned (200).

        * If no fn is registered yet, an ``awaiting_human`` event is recorded so the

        re-trigger is durable + visible, and 202 is returned for the founder/sweep

        to action manually.'
      operationId: rerun_step_api_v1_ops_projects__project_id__steps__step_key__run_post
      security:
      - HTTPBearer: []
      parameters:
      - name: project_id
        in: path
        required: true
        schema:
          type: string
          title: Project Id
      - name: step_key
        in: path
        required: true
        schema:
          type: string
          title: Step Key
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/RunStepRequest'
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Rerun Step Api V1 Ops Projects  Project Id  Steps  Step Key  Run Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/ops/projects/{project_id}/health:
    get:
      tags:
      - ops
      summary: Project Health
      description: 'Per-step latest-status rollup for a project. Founder-only.


        For each ``step_key`` that has ever run, returns the latest event''s status,

        attempt count, error, and timing — the single call that answers "where is

        this project, and what''s broken?" (§WS11 acceptance).'
      operationId: project_health_api_v1_ops_projects__project_id__health_get
      security:
      - HTTPBearer: []
      parameters:
      - name: project_id
        in: path
        required: true
        schema:
          type: string
          title: Project Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Project Health Api V1 Ops Projects  Project Id  Health Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RunStepRequest:
      properties:
        force:
          type: boolean
          title: Force
          default: false
      type: object
      title: RunStepRequest
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key