openapi.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "AgentFlow Query API",
    "description": "Real-time data access for AI agents",
    "version": "2.1.0"
  },
  "paths": {
    "/v1/query/explain": {
      "post": {
        "tags": [
          "agent"
        ],
        "summary": "Explain Query",
        "description": "Return the SQL plan for a natural language query without executing it.",
        "operationId": "explain_query_v1_query_explain_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExplainRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExplainResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/query": {
      "post": {
        "tags": [
          "agent"
        ],
        "summary": "Natural Language Query",
        "description": "Execute a natural language query against the data platform.\n\nThe query engine translates natural language to SQL, executes it,\nand returns structured results. Designed for LLM tool-use.\n\nExample:\n    POST /v1/query {\"question\": \"Top 5 products by revenue today\"}",
        "operationId": "natural_language_query_v1_query_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NLQueryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueryResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/entity/{entity_type}/{entity_id}": {
      "get": {
        "tags": [
          "agent"
        ],
        "summary": "Get Entity",
        "description": "Look up a specific entity by type and ID.\n\nSupported entity types: order, user, product, session.\nReturns the latest known state of the entity.\n\nExample:\n    GET /v1/entity/order/ORD-20260401-7829",
        "operationId": "get_entity_v1_entity__entity_type___entity_id__get",
        "parameters": [
          {
            "name": "entity_type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity Type"
            }
          },
          {
            "name": "entity_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity Id"
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Return state as of this UTC timestamp (ISO 8601)",
              "title": "As Of"
            },
            "description": "Return state as of this UTC timestamp (ISO 8601)"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/entity/order/{order_id}/timeline": {
      "get": {
        "tags": [
          "agent"
        ],
        "summary": "Get Order Timeline",
        "description": "Order 360: order state, stage history, pipeline trail, customer block,\nand linked exceptions \u2014 one composed read (ops-surfaces-spec.md \u00a72).\n\nSame tenant scoping and 404 semantics as GET /entity/order/{order_id}.\nNot cached: this is the \"now\" surface (ADR 0011 constraint 3, spec \u00a71.8).\n\nExample:\n    GET /v1/entity/order/ORD-20260404-1001/timeline",
        "operationId": "get_order_timeline_v1_entity_order__order_id__timeline_get",
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Order Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderTimelineResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/metrics/{metric_name}": {
      "get": {
        "tags": [
          "agent"
        ],
        "summary": "Get Metric",
        "description": "Get a real-time metric value.\n\nSupported metrics: revenue, order_count, avg_order_value, conversion_rate,\nactive_sessions, error_rate.\n\nWindow options: 5m, 15m, 1h, 6h, 24h.\n\nExample:\n    GET /v1/metrics/revenue?window=1h",
        "operationId": "get_metric_v1_metrics__metric_name__get",
        "parameters": [
          {
            "name": "metric_name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Metric Name"
            }
          },
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "1h",
              "title": "Window"
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Compute the metric at this UTC timestamp (ISO 8601)",
              "title": "As Of"
            },
            "description": "Compute the metric at this UTC timestamp (ISO 8601)"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MetricResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/batch": {
      "post": {
        "tags": [
          "agent"
        ],
        "summary": "Batch Query",
        "operationId": "batch_query_v1_batch_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys": {
      "post": {
        "tags": [
          "admin"
        ],
        "summary": "Create Api Key",
        "operationId": "create_api_key_v1_admin_keys_post",
        "parameters": [
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KeyCreateRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "List Api Keys",
        "operationId": "list_api_keys_v1_admin_keys_get",
        "parameters": [
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys/{key_id}/rotate": {
      "post": {
        "tags": [
          "admin"
        ],
        "summary": "Rotate Api Key",
        "operationId": "rotate_api_key_v1_admin_keys__key_id__rotate_post",
        "parameters": [
          {
            "name": "key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Key Id"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys/{key_id}/rotation-status": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Rotation Status",
        "operationId": "get_rotation_status_v1_admin_keys__key_id__rotation_status_get",
        "parameters": [
          {
            "name": "key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Key Id"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys/{key_id}/revoke-old": {
      "post": {
        "tags": [
          "admin"
        ],
        "summary": "Revoke Old Api Key",
        "operationId": "revoke_old_api_key_v1_admin_keys__key_id__revoke_old_post",
        "parameters": [
          {
            "name": "key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Key Id"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys/{key_id}": {
      "delete": {
        "tags": [
          "admin"
        ],
        "summary": "Revoke Api Key",
        "operationId": "revoke_api_key_v1_admin_keys__key_id__delete",
        "parameters": [
          {
            "name": "key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Key Id"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/usage": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Usage",
        "operationId": "get_usage_v1_admin_usage_get",
        "parameters": [
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/analytics/usage": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Analytics Usage",
        "operationId": "get_analytics_usage_v1_admin_analytics_usage_get",
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "24h",
              "title": "Window"
            }
          },
          {
            "name": "tenant",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Tenant"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/analytics/top-queries": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Analytics Top Queries",
        "operationId": "get_analytics_top_queries_v1_admin_analytics_top_queries_get",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 10,
              "title": "Limit"
            }
          },
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "24h",
              "title": "Window"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/analytics/top-entities": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Analytics Top Entities",
        "operationId": "get_analytics_top_entities_v1_admin_analytics_top_entities_get",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 10,
              "title": "Limit"
            }
          },
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "24h",
              "title": "Window"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/analytics/latency": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Analytics Latency",
        "operationId": "get_analytics_latency_v1_admin_analytics_latency_get",
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "24h",
              "title": "Window"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/analytics/anomalies": {
      "get": {
        "tags": [
          "admin"
        ],
        "summary": "Get Analytics Anomalies",
        "operationId": "get_analytics_anomalies_v1_admin_analytics_anomalies_get",
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "24h",
              "title": "Window"
            }
          },
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/analytics/retention": {
      "post": {
        "tags": [
          "admin"
        ],
        "summary": "Prune Analytics Retention",
        "operationId": "prune_analytics_retention_v1_admin_analytics_retention_post",
        "parameters": [
          {
            "name": "X-Admin-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Admin-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AnalyticsRetentionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AnalyticsRetentionResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/alerts": {
      "get": {
        "tags": [
          "alerts"
        ],
        "summary": "List My Alerts",
        "operationId": "list_my_alerts_v1_alerts_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response List My Alerts V1 Alerts Get"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "alerts"
        ],
        "summary": "Register Alert",
        "operationId": "register_alert_v1_alerts_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlertCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Register Alert V1 Alerts Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/alerts/{alert_id}": {
      "put": {
        "tags": [
          "alerts"
        ],
        "summary": "Modify Alert",
        "operationId": "modify_alert_v1_alerts__alert_id__put",
        "parameters": [
          {
            "name": "alert_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Alert Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlertUpdateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Modify Alert V1 Alerts  Alert Id  Put"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "alerts"
        ],
        "summary": "Remove Alert",
        "operationId": "remove_alert_v1_alerts__alert_id__delete",
        "parameters": [
          {
            "name": "alert_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Alert Id"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/alerts/{alert_id}/test": {
      "post": {
        "tags": [
          "alerts"
        ],
        "summary": "Test Alert",
        "operationId": "test_alert_v1_alerts__alert_id__test_post",
        "parameters": [
          {
            "name": "alert_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Alert Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Test Alert V1 Alerts  Alert Id  Test Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/alerts/{alert_id}/history": {
      "get": {
        "tags": [
          "alerts"
        ],
        "summary": "Alert History",
        "operationId": "alert_history_v1_alerts__alert_id__history_get",
        "parameters": [
          {
            "name": "alert_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Alert Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Alert History V1 Alerts  Alert Id  History Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contracts": {
      "get": {
        "tags": [
          "contracts"
        ],
        "summary": "List Contracts",
        "operationId": "list_contracts_v1_contracts_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response List Contracts V1 Contracts Get"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contracts/{entity}/diff/{from_version}/{to_version}": {
      "get": {
        "tags": [
          "contracts"
        ],
        "summary": "Diff Contract Versions",
        "operationId": "diff_contract_versions_v1_contracts__entity__diff__from_version___to_version__get",
        "parameters": [
          {
            "name": "entity",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity"
            }
          },
          {
            "name": "from_version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "From Version"
            }
          },
          {
            "name": "to_version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "To Version"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Diff Contract Versions V1 Contracts  Entity  Diff  From Version   To Version  Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contracts/{entity}/validate": {
      "post": {
        "tags": [
          "contracts"
        ],
        "summary": "Validate Contract",
        "operationId": "validate_contract_v1_contracts__entity__validate_post",
        "parameters": [
          {
            "name": "entity",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true,
                "title": "Candidate Schema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Validate Contract V1 Contracts  Entity  Validate Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contracts/{entity}/{version}": {
      "get": {
        "tags": [
          "contracts"
        ],
        "summary": "Get Contract Version",
        "operationId": "get_contract_version_v1_contracts__entity___version__get",
        "parameters": [
          {
            "name": "entity",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Version"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Get Contract Version V1 Contracts  Entity   Version  Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contracts/{entity}": {
      "get": {
        "tags": [
          "contracts"
        ],
        "summary": "Get Latest Contract",
        "operationId": "get_latest_contract_v1_contracts__entity__get",
        "parameters": [
          {
            "name": "entity",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Get Latest Contract V1 Contracts  Entity  Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/deadletter/stats": {
      "get": {
        "tags": [
          "deadletter"
        ],
        "summary": "Deadletter Stats",
        "operationId": "deadletter_stats_v1_deadletter_stats_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeadLetterStatsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/deadletter": {
      "get": {
        "tags": [
          "deadletter"
        ],
        "summary": "List Deadletter Events",
        "operationId": "list_deadletter_events_v1_deadletter_get",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Page Size"
            }
          },
          {
            "name": "reason",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Reason"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeadLetterListResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/deadletter/{event_id}": {
      "get": {
        "tags": [
          "deadletter"
        ],
        "summary": "Get Deadletter Event",
        "operationId": "get_deadletter_event_v1_deadletter__event_id__get",
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Event Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeadLetterDetail"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/deadletter/{event_id}/replay": {
      "post": {
        "tags": [
          "deadletter"
        ],
        "summary": "Replay Deadletter Event",
        "operationId": "replay_deadletter_event_v1_deadletter__event_id__replay_post",
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Event Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/ReplayRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Payload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReplayResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/deadletter/{event_id}/dismiss": {
      "post": {
        "tags": [
          "deadletter"
        ],
        "summary": "Dismiss Deadletter Event",
        "operationId": "dismiss_deadletter_event_v1_deadletter__event_id__dismiss_post",
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Event Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DismissResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/lineage/{entity_type}/{entity_id}": {
      "get": {
        "tags": [
          "lineage"
        ],
        "summary": "Get provenance chain for an entity",
        "description": "Return the reconstructed lineage for an entity from source to serving.",
        "operationId": "get_lineage_v1_lineage__entity_type___entity_id__get",
        "parameters": [
          {
            "name": "entity_type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity Type"
            }
          },
          {
            "name": "entity_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Entity Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LineageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ops/stuck-orders": {
      "get": {
        "tags": [
          "ops"
        ],
        "summary": "Get Stuck Orders",
        "operationId": "get_stuck_orders_v1_ops_stuck_orders_get",
        "parameters": [
          {
            "name": "stage",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Stage"
            }
          },
          {
            "name": "include_within_sla",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false,
              "title": "Include Within Sla"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Page Size"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StuckOrdersResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ops/exceptions": {
      "get": {
        "tags": [
          "ops"
        ],
        "summary": "List Exceptions",
        "operationId": "list_exceptions_v1_ops_exceptions_get",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "deadletter",
                    "webhook_delivery",
                    "reconciliation"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Source"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "open",
                    "in_progress",
                    "acknowledged",
                    "resolved"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Page Size"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionsListResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ops/exceptions/stats": {
      "get": {
        "tags": [
          "ops"
        ],
        "summary": "Exceptions Stats",
        "operationId": "exceptions_stats_v1_ops_exceptions_stats_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionsStatsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ops/exceptions/{item_id}/acknowledge": {
      "post": {
        "tags": [
          "ops"
        ],
        "summary": "Acknowledge Exception",
        "operationId": "acknowledge_exception_v1_ops_exceptions__item_id__acknowledge_post",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Item Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/TriageActionRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Payload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TriageActionResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ops/exceptions/{item_id}/resolve": {
      "post": {
        "tags": [
          "ops"
        ],
        "summary": "Resolve Exception",
        "operationId": "resolve_exception_v1_ops_exceptions__item_id__resolve_post",
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Item Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/TriageActionRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Payload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TriageActionResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/search": {
      "get": {
        "tags": [
          "search"
        ],
        "summary": "Search",
        "operationId": "search_v1_search_get",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 2,
              "description": "Natural language search query",
              "title": "Q"
            },
            "description": "Natural language search query"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 50,
              "minimum": 1,
              "default": 10,
              "title": "Limit"
            }
          },
          {
            "name": "entity_types",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                {
                  "type": "null"
                }
              ],
              "title": "Entity Types"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/slo": {
      "get": {
        "tags": [
          "slo"
        ],
        "summary": "Get Slos",
        "operationId": "get_slos_v1_slo_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SLOResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/stream/events": {
      "get": {
        "tags": [
          "stream"
        ],
        "summary": "Stream real-time validated events via SSE",
        "description": "Server-Sent Events stream of validated pipeline events.",
        "operationId": "stream_events_v1_stream_events_get",
        "parameters": [
          {
            "name": "event_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Event Type"
            }
          },
          {
            "name": "entity_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Entity Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks": {
      "get": {
        "tags": [
          "webhooks"
        ],
        "summary": "List My Webhooks",
        "operationId": "list_my_webhooks_v1_webhooks_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response List My Webhooks V1 Webhooks Get"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "webhooks"
        ],
        "summary": "Register Webhook",
        "operationId": "register_webhook_v1_webhooks_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Register Webhook V1 Webhooks Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/{webhook_id}": {
      "delete": {
        "tags": [
          "webhooks"
        ],
        "summary": "Unregister Webhook",
        "operationId": "unregister_webhook_v1_webhooks__webhook_id__delete",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Webhook Id"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/{webhook_id}/test": {
      "post": {
        "tags": [
          "webhooks"
        ],
        "summary": "Test Webhook",
        "operationId": "test_webhook_v1_webhooks__webhook_id__test_post",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Webhook Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Test Webhook V1 Webhooks  Webhook Id  Test Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/{webhook_id}/logs": {
      "get": {
        "tags": [
          "webhooks"
        ],
        "summary": "Webhook Logs",
        "operationId": "webhook_logs_v1_webhooks__webhook_id__logs_get",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Webhook Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Webhook Logs V1 Webhooks  Webhook Id  Logs Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/changelog": {
      "get": {
        "summary": "Changelog",
        "description": "Return the configured date-based API version history.",
        "operationId": "changelog_v1_changelog_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/catalog": {
      "get": {
        "summary": "Catalog",
        "description": "List available entities, metrics, and streaming sources for agents.",
        "operationId": "catalog_v1_catalog_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/health/live": {
      "get": {
        "summary": "Health Live",
        "description": "Liveness: this process is up. No dependencies, by design.\n\nKubernetes restarts a container that fails liveness, so a dependency must\nnever appear here \u2014 a ClickHouse outage would otherwise roll every pod.",
        "operationId": "health_live_health_live_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/health/ready": {
      "get": {
        "summary": "Health Ready",
        "description": "Readiness: the dependencies this replica needs to answer a request.\n\nNon-200 when the serving store is unreachable or unprovisioned, so\nKubernetes takes the pod out of the Service instead of routing traffic to a\nreplica that can only fail. `/v1/health` cannot do this job: it always\nanswered 200 (payload-only status), and both k8s probes and the Compose\nhealthcheck pointed at it \u2014 so an API with a dead ClickHouse looked healthy\nto every orchestrator watching it (audit P0-3).",
        "operationId": "health_ready_health_ready_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/health": {
      "get": {
        "summary": "Health",
        "description": "Pipeline health check - agents should call this before answering time-sensitive queries.\n\nReturns overall pipeline status and per-component health. Informational and\nalways 200: an agent asking \"is the data fresh enough to answer with?\" wants\nthe payload, not an HTTP error. Orchestrators use /health/live and\n/health/ready, which do fail.\n\nIf status != \"healthy\", agents should caveat their answers with data freshness warnings.",
        "operationId": "health_v1_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AlertCreateRequest": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "title": "Name"
          },
          "metric": {
            "type": "string",
            "title": "Metric"
          },
          "window": {
            "type": "string",
            "title": "Window",
            "default": "1h"
          },
          "condition": {
            "type": "string",
            "enum": [
              "above",
              "below",
              "change_pct"
            ],
            "title": "Condition"
          },
          "threshold": {
            "type": "number",
            "title": "Threshold"
          },
          "webhook_url": {
            "type": "string",
            "minLength": 1,
            "format": "uri",
            "title": "Webhook Url"
          },
          "cooldown_minutes": {
            "type": "integer",
            "maximum": 1440.0,
            "minimum": 0.0,
            "title": "Cooldown Minutes",
            "default": 30
          }
        },
        "type": "object",
        "required": [
          "name",
          "metric",
          "condition",
          "threshold",
          "webhook_url"
        ],
        "title": "AlertCreateRequest"
      },
      "AlertUpdateRequest": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "metric": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Metric"
          },
          "window": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Window"
          },
          "condition": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "above",
                  "below",
                  "change_pct"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Condition"
          },
          "threshold": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Threshold"
          },
          "webhook_url": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "title": "Webhook Url"
          },
          "cooldown_minutes": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 1440.0,
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Cooldown Minutes"
          },
          "active": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Active"
          }
        },
        "type": "object",
        "title": "AlertUpdateRequest"
      },
      "AnalyticsRetentionRequest": {
        "properties": {
          "retention_days": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Retention Days"
          },
          "dry_run": {
            "type": "boolean",
            "title": "Dry Run",
            "default": false
          }
        },
        "type": "object",
        "title": "AnalyticsRetentionRequest"
      },
      "AnalyticsRetentionResponse": {
        "properties": {
          "retention_days": {
            "type": "integer",
            "title": "Retention Days"
          },
          "dry_run": {
            "type": "boolean",
            "title": "Dry Run"
          },
          "deleted_rows": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Deleted Rows"
          }
        },
        "type": "object",
        "required": [
          "retention_days",
          "dry_run",
          "deleted_rows"
        ],
        "title": "AnalyticsRetentionResponse"
      },
      "BatchItem": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "type": {
            "type": "string",
            "enum": [
              "entity",
              "metric",
              "query"
            ],
            "title": "Type"
          },
          "params": {
            "additionalProperties": true,
            "type": "object",
            "title": "Params"
          }
        },
        "type": "object",
        "required": [
          "id",
          "type"
        ],
        "title": "BatchItem"
      },
      "BatchRequest": {
        "properties": {
          "requests": {
            "items": {
              "$ref": "#/components/schemas/BatchItem"
            },
            "type": "array",
            "maxItems": 20,
            "title": "Requests"
          }
        },
        "type": "object",
        "required": [
          "requests"
        ],
        "title": "BatchRequest"
      },
      "BatchResponse": {
        "properties": {
          "results": {
            "items": {
              "$ref": "#/components/schemas/BatchResult"
            },
            "type": "array",
            "title": "Results"
          },
          "duration_ms": {
            "type": "number",
            "title": "Duration Ms"
          }
        },
        "type": "object",
        "required": [
          "results",
          "duration_ms"
        ],
        "title": "BatchResponse"
      },
      "BatchResult": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "error"
            ],
            "title": "Status"
          },
          "data": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          }
        },
        "type": "object",
        "required": [
          "id",
          "status"
        ],
        "title": "BatchResult"
      },
      "DeadLetterDetail": {
        "properties": {
          "event_id": {
            "type": "string",
            "title": "Event Id"
          },
          "event_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Type"
          },
          "failure_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Failure Reason"
          },
          "failure_detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Failure Detail"
          },
          "received_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Received At"
          },
          "retry_count": {
            "type": "integer",
            "title": "Retry Count",
            "default": 0
          },
          "last_retried_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Retried At"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "payload": {
            "additionalProperties": true,
            "type": "object",
            "title": "Payload"
          }
        },
        "type": "object",
        "required": [
          "event_id",
          "status",
          "payload"
        ],
        "title": "DeadLetterDetail"
      },
      "DeadLetterListResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/DeadLetterSummary"
            },
            "type": "array",
            "title": "Items"
          },
          "pagination": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Pagination"
          }
        },
        "type": "object",
        "required": [
          "items",
          "pagination"
        ],
        "title": "DeadLetterListResponse"
      },
      "DeadLetterStatsResponse": {
        "properties": {
          "counts": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Counts"
          },
          "last_24h": {
            "type": "integer",
            "title": "Last 24H"
          },
          "trend": {
            "items": {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "string"
                  }
                ]
              },
              "type": "object"
            },
            "type": "array",
            "title": "Trend"
          }
        },
        "type": "object",
        "required": [
          "counts",
          "last_24h"
        ],
        "title": "DeadLetterStatsResponse"
      },
      "DeadLetterSummary": {
        "properties": {
          "event_id": {
            "type": "string",
            "title": "Event Id"
          },
          "event_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Type"
          },
          "failure_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Failure Reason"
          },
          "failure_detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Failure Detail"
          },
          "received_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Received At"
          },
          "retry_count": {
            "type": "integer",
            "title": "Retry Count",
            "default": 0
          },
          "last_retried_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Retried At"
          },
          "status": {
            "type": "string",
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "event_id",
          "status"
        ],
        "title": "DeadLetterSummary"
      },
      "DismissResponse": {
        "properties": {
          "event_id": {
            "type": "string",
            "title": "Event Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "event_id",
          "status"
        ],
        "title": "DismissResponse"
      },
      "EntityRef": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "event",
              "order",
              "webhook"
            ],
            "title": "Kind"
          },
          "id": {
            "type": "string",
            "title": "Id"
          }
        },
        "type": "object",
        "required": [
          "kind",
          "id"
        ],
        "title": "EntityRef"
      },
      "EntityResponse": {
        "properties": {
          "entity_type": {
            "type": "string",
            "title": "Entity Type"
          },
          "entity_id": {
            "type": "string",
            "title": "Entity Id"
          },
          "data": {
            "additionalProperties": true,
            "type": "object",
            "title": "Data"
          },
          "last_updated": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Updated"
          },
          "freshness_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Freshness Seconds"
          },
          "meta": {
            "additionalProperties": true,
            "type": "object",
            "title": "Meta"
          }
        },
        "type": "object",
        "required": [
          "entity_type",
          "entity_id",
          "data"
        ],
        "title": "EntityResponse"
      },
      "ExceptionAction": {
        "properties": {
          "action": {
            "type": "string",
            "title": "Action"
          },
          "href": {
            "type": "string",
            "title": "Href"
          }
        },
        "type": "object",
        "required": [
          "action",
          "href"
        ],
        "title": "ExceptionAction"
      },
      "ExceptionItem": {
        "properties": {
          "item_id": {
            "type": "string",
            "title": "Item Id"
          },
          "source": {
            "type": "string",
            "enum": [
              "deadletter",
              "webhook_delivery",
              "reconciliation"
            ],
            "title": "Source"
          },
          "severity": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ],
            "title": "Severity"
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "title": "Occurred At"
          },
          "last_seen_at": {
            "type": "string",
            "format": "date-time",
            "title": "Last Seen At"
          },
          "entity_ref": {
            "$ref": "#/components/schemas/EntityRef"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "detail": {
            "type": "string",
            "title": "Detail"
          },
          "status": {
            "type": "string",
            "enum": [
              "open",
              "in_progress",
              "acknowledged",
              "resolved"
            ],
            "title": "Status"
          },
          "actions": {
            "items": {
              "$ref": "#/components/schemas/ExceptionAction"
            },
            "type": "array",
            "title": "Actions"
          }
        },
        "type": "object",
        "required": [
          "item_id",
          "source",
          "severity",
          "occurred_at",
          "last_seen_at",
          "entity_ref",
          "title",
          "detail",
          "status",
          "actions"
        ],
        "title": "ExceptionItem"
      },
      "ExceptionsListResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ExceptionItem"
            },
            "type": "array",
            "title": "Items"
          },
          "pagination": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Pagination"
          },
          "scan_truncated": {
            "type": "boolean",
            "title": "Scan Truncated",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "items",
          "pagination"
        ],
        "title": "ExceptionsListResponse"
      },
      "ExceptionsStatsResponse": {
        "properties": {
          "by_source": {
            "additionalProperties": {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            "type": "object",
            "title": "By Source"
          },
          "last_24h": {
            "type": "integer",
            "title": "Last 24H"
          },
          "manual_resolutions": {
            "type": "integer",
            "title": "Manual Resolutions"
          },
          "scan_truncated": {
            "type": "boolean",
            "title": "Scan Truncated",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "last_24h",
          "manual_resolutions"
        ],
        "title": "ExceptionsStatsResponse"
      },
      "ExplainRequest": {
        "properties": {
          "question": {
            "type": "string",
            "maxLength": 1000,
            "minLength": 3,
            "title": "Question",
            "examples": [
              "Top 5 products by revenue today"
            ]
          }
        },
        "type": "object",
        "required": [
          "question"
        ],
        "title": "ExplainRequest"
      },
      "ExplainResponse": {
        "properties": {
          "question": {
            "type": "string",
            "title": "Question"
          },
          "sql": {
            "type": "string",
            "title": "Sql"
          },
          "tables_accessed": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tables Accessed"
          },
          "estimated_rows": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Estimated Rows"
          },
          "engine": {
            "type": "string",
            "enum": [
              "llm",
              "rule_based"
            ],
            "title": "Engine"
          },
          "warning": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Warning"
          }
        },
        "type": "object",
        "required": [
          "question",
          "sql",
          "tables_accessed",
          "engine"
        ],
        "title": "ExplainResponse"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "KeyCreateRequest": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "tenant": {
            "type": "string",
            "title": "Tenant"
          },
          "rate_limit_rpm": {
            "type": "integer",
            "minimum": 1.0,
            "title": "Rate Limit Rpm",
            "default": 120
          },
          "allowed_entity_types": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allowed Entity Types"
          }
        },
        "type": "object",
        "required": [
          "name",
          "tenant"
        ],
        "title": "KeyCreateRequest"
      },
      "LineageNode": {
        "properties": {
          "layer": {
            "type": "string",
            "title": "Layer"
          },
          "system": {
            "type": "string",
            "title": "System"
          },
          "table_or_topic": {
            "type": "string",
            "title": "Table Or Topic"
          },
          "processed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processed At"
          },
          "quality_score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quality Score"
          }
        },
        "type": "object",
        "required": [
          "layer",
          "system",
          "table_or_topic",
          "processed_at",
          "quality_score"
        ],
        "title": "LineageNode"
      },
      "LineageResponse": {
        "properties": {
          "entity_type": {
            "type": "string",
            "title": "Entity Type"
          },
          "entity_id": {
            "type": "string",
            "title": "Entity Id"
          },
          "lineage": {
            "items": {
              "$ref": "#/components/schemas/LineageNode"
            },
            "type": "array",
            "title": "Lineage"
          },
          "freshness_seconds": {
            "type": "number",
            "title": "Freshness Seconds"
          },
          "validated": {
            "type": "boolean",
            "title": "Validated"
          },
          "enriched": {
            "type": "boolean",
            "title": "Enriched"
          }
        },
        "type": "object",
        "required": [
          "entity_type",
          "entity_id",
          "lineage",
          "freshness_seconds",
          "validated",
          "enriched"
        ],
        "title": "LineageResponse"
      },
      "MetricResponse": {
        "properties": {
          "metric_name": {
            "type": "string",
            "title": "Metric Name"
          },
          "value": {
            "type": "number",
            "title": "Value"
          },
          "unit": {
            "type": "string",
            "title": "Unit"
          },
          "window": {
            "type": "string",
            "title": "Window"
          },
          "computed_at": {
            "type": "string",
            "format": "date-time",
            "title": "Computed At"
          },
          "components": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Components"
          },
          "meta": {
            "additionalProperties": true,
            "type": "object",
            "title": "Meta"
          }
        },
        "type": "object",
        "required": [
          "metric_name",
          "value",
          "unit",
          "window",
          "computed_at"
        ],
        "title": "MetricResponse"
      },
      "NLQueryRequest": {
        "properties": {
          "question": {
            "type": "string",
            "maxLength": 1000,
            "minLength": 3,
            "title": "Question",
            "examples": [
              "What is the average order value in the last hour?"
            ]
          },
          "context": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Context",
            "description": "Additional context for query generation"
          },
          "limit": {
            "type": "integer",
            "maximum": 1000.0,
            "minimum": 1.0,
            "title": "Limit",
            "default": 100
          },
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cursor"
          }
        },
        "type": "object",
        "required": [
          "question"
        ],
        "title": "NLQueryRequest"
      },
      "OrderTimelineCustomer": {
        "properties": {
          "user_id": {
            "type": "string",
            "title": "User Id"
          },
          "total_orders": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Orders"
          },
          "total_spent": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Spent"
          },
          "first_order_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "First Order At"
          },
          "last_order_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Order At"
          },
          "preferred_category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Preferred Category"
          }
        },
        "type": "object",
        "required": [
          "user_id"
        ],
        "title": "OrderTimelineCustomer"
      },
      "OrderTimelineException": {
        "properties": {
          "event_id": {
            "type": "string",
            "title": "Event Id"
          },
          "failure_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Failure Reason"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "occurred_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Occurred At"
          },
          "actions": {
            "$ref": "#/components/schemas/OrderTimelineExceptionActions"
          }
        },
        "type": "object",
        "required": [
          "event_id",
          "status",
          "actions"
        ],
        "title": "OrderTimelineException"
      },
      "OrderTimelineExceptionActions": {
        "properties": {
          "replay": {
            "type": "string",
            "title": "Replay"
          },
          "dismiss": {
            "type": "string",
            "title": "Dismiss"
          }
        },
        "type": "object",
        "required": [
          "replay",
          "dismiss"
        ],
        "title": "OrderTimelineExceptionActions"
      },
      "OrderTimelineOrder": {
        "properties": {
          "order_id": {
            "type": "string",
            "title": "Order Id"
          },
          "user_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Id"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "total_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Amount"
          },
          "currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Currency"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "order_id"
        ],
        "title": "OrderTimelineOrder"
      },
      "OrderTimelinePipelineTrailItem": {
        "properties": {
          "event_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Id"
          },
          "topic": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Topic"
          },
          "event_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Type"
          },
          "latency_ms": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Latency Ms"
          },
          "processed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processed At"
          }
        },
        "type": "object",
        "title": "OrderTimelinePipelineTrailItem"
      },
      "OrderTimelineResponse": {
        "properties": {
          "order": {
            "$ref": "#/components/schemas/OrderTimelineOrder"
          },
          "stage": {
            "$ref": "#/components/schemas/OrderTimelineStage"
          },
          "stage_history": {
            "items": {
              "$ref": "#/components/schemas/OrderTimelineStageHistoryItem"
            },
            "type": "array",
            "title": "Stage History"
          },
          "pipeline_trail": {
            "items": {
              "$ref": "#/components/schemas/OrderTimelinePipelineTrailItem"
            },
            "type": "array",
            "title": "Pipeline Trail"
          },
          "customer": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OrderTimelineCustomer"
              },
              {
                "type": "null"
              }
            ]
          },
          "exceptions": {
            "items": {
              "$ref": "#/components/schemas/OrderTimelineException"
            },
            "type": "array",
            "title": "Exceptions"
          }
        },
        "type": "object",
        "required": [
          "order",
          "stage"
        ],
        "title": "OrderTimelineResponse"
      },
      "OrderTimelineStage": {
        "properties": {
          "current": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current"
          },
          "entered_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entered At"
          },
          "in_stage_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "In Stage Seconds"
          },
          "sla_minutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sla Minutes"
          },
          "breached": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Breached"
          },
          "clock": {
            "type": "string",
            "enum": [
              "journal",
              "fallback"
            ],
            "title": "Clock"
          }
        },
        "type": "object",
        "required": [
          "clock"
        ],
        "title": "OrderTimelineStage"
      },
      "OrderTimelineStageHistoryItem": {
        "properties": {
          "status": {
            "type": "string",
            "title": "Status"
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "At"
          }
        },
        "type": "object",
        "required": [
          "status"
        ],
        "title": "OrderTimelineStageHistoryItem"
      },
      "QueryResponse": {
        "properties": {
          "answer": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "items": {},
                "type": "array"
              }
            ],
            "title": "Answer"
          },
          "rows": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Rows"
          },
          "sql": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sql"
          },
          "total_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Count"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor"
          },
          "has_more": {
            "type": "boolean",
            "title": "Has More",
            "default": false
          },
          "page_size": {
            "type": "integer",
            "title": "Page Size"
          },
          "metadata": {
            "additionalProperties": true,
            "type": "object",
            "title": "Metadata"
          }
        },
        "type": "object",
        "required": [
          "answer",
          "page_size"
        ],
        "title": "QueryResponse"
      },
      "ReplayRequest": {
        "properties": {
          "corrected_payload": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Corrected Payload"
          }
        },
        "type": "object",
        "title": "ReplayRequest"
      },
      "ReplayResponse": {
        "properties": {
          "event_id": {
            "type": "string",
            "title": "Event Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "retry_count": {
            "type": "integer",
            "title": "Retry Count"
          },
          "last_retried_at": {
            "type": "string",
            "format": "date-time",
            "title": "Last Retried At"
          }
        },
        "type": "object",
        "required": [
          "event_id",
          "status",
          "retry_count",
          "last_retried_at"
        ],
        "title": "ReplayResponse"
      },
      "SLOResponse": {
        "properties": {
          "slos": {
            "items": {
              "$ref": "#/components/schemas/SLOStatus"
            },
            "type": "array",
            "title": "Slos"
          }
        },
        "type": "object",
        "required": [
          "slos"
        ],
        "title": "SLOResponse"
      },
      "SLOStatus": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "target": {
            "type": "number",
            "title": "Target"
          },
          "current": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current"
          },
          "error_budget_remaining": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Budget Remaining"
          },
          "status": {
            "type": "string",
            "enum": [
              "healthy",
              "at_risk",
              "breached",
              "unknown"
            ],
            "title": "Status"
          },
          "window_days": {
            "type": "integer",
            "title": "Window Days"
          },
          "good": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Good"
          },
          "valid": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Valid"
          },
          "unit": {
            "type": "string",
            "enum": [
              "events",
              "seconds"
            ],
            "title": "Unit"
          },
          "burn_rates": {
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "type": "object",
            "title": "Burn Rates"
          },
          "diagnostic": {
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "type": "object",
            "title": "Diagnostic"
          }
        },
        "type": "object",
        "required": [
          "name",
          "target",
          "current",
          "error_budget_remaining",
          "status",
          "window_days",
          "good",
          "valid",
          "unit",
          "burn_rates",
          "diagnostic"
        ],
        "title": "SLOStatus",
        "description": "One SLO, reported as a real SLI (audit P2-2): ``current`` is the share\nof good units among valid units over the SLO window \u2014 a fraction of\nevents for latency/error SLIs, a fraction of observed time for the\nfreshness SLI \u2014 never a rescaled point aggregate. ``None`` means the\nwindow holds no valid units: *unknown*, deliberately distinct from 0.0\n(an empty journal is not a breached SLO)."
      },
      "SearchResponse": {
        "properties": {
          "query": {
            "type": "string",
            "title": "Query"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/SearchResult"
            },
            "type": "array",
            "title": "Results"
          },
          "partial": {
            "type": "boolean",
            "title": "Partial"
          },
          "degraded": {
            "type": "boolean",
            "title": "Degraded"
          },
          "indexed_documents": {
            "type": "integer",
            "title": "Indexed Documents"
          },
          "entity_scan_limit": {
            "type": "integer",
            "title": "Entity Scan Limit"
          },
          "partial_entity_types": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Partial Entity Types"
          },
          "failed_entity_types": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Failed Entity Types"
          }
        },
        "type": "object",
        "required": [
          "query",
          "results",
          "partial",
          "degraded",
          "indexed_documents",
          "entity_scan_limit",
          "partial_entity_types",
          "failed_entity_types"
        ],
        "title": "SearchResponse"
      },
      "SearchResult": {
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "entity",
              "metric",
              "catalog_field"
            ],
            "title": "Type"
          },
          "id": {
            "type": "string",
            "title": "Id"
          },
          "entity_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entity Type"
          },
          "score": {
            "type": "number",
            "title": "Score"
          },
          "snippet": {
            "type": "string",
            "title": "Snippet"
          },
          "endpoint": {
            "type": "string",
            "title": "Endpoint"
          }
        },
        "type": "object",
        "required": [
          "type",
          "id",
          "entity_type",
          "score",
          "snippet",
          "endpoint"
        ],
        "title": "SearchResult"
      },
      "StuckOrderItem": {
        "properties": {
          "order_id": {
            "type": "string",
            "title": "Order Id"
          },
          "user_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "entered_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entered At"
          },
          "in_stage_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "In Stage Seconds"
          },
          "sla_minutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sla Minutes"
          },
          "overshoot_ratio": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Overshoot Ratio"
          },
          "clock": {
            "type": "string",
            "enum": [
              "journal",
              "fallback"
            ],
            "title": "Clock"
          },
          "total_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Amount"
          },
          "currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Currency"
          }
        },
        "type": "object",
        "required": [
          "order_id",
          "status",
          "clock"
        ],
        "title": "StuckOrderItem"
      },
      "StuckOrdersResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/StuckOrderItem"
            },
            "type": "array",
            "title": "Items"
          },
          "summary": {
            "$ref": "#/components/schemas/StuckOrdersSummary"
          },
          "pagination": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Pagination"
          },
          "scan_truncated": {
            "type": "boolean",
            "title": "Scan Truncated",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "items",
          "summary",
          "pagination"
        ],
        "title": "StuckOrdersResponse"
      },
      "StuckOrdersSummary": {
        "properties": {
          "open_by_stage": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Open By Stage"
          },
          "breached_by_stage": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Breached By Stage"
          }
        },
        "type": "object",
        "title": "StuckOrdersSummary"
      },
      "TriageActionRequest": {
        "properties": {
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Note"
          }
        },
        "type": "object",
        "title": "TriageActionRequest"
      },
      "TriageActionResponse": {
        "properties": {
          "item_id": {
            "type": "string",
            "title": "Item Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "item_id",
          "status"
        ],
        "title": "TriageActionResponse"
      },
      "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"
      },
      "WebhookCreateRequest": {
        "properties": {
          "url": {
            "type": "string",
            "minLength": 1,
            "format": "uri",
            "title": "Url"
          },
          "filters": {
            "$ref": "#/components/schemas/WebhookFilters"
          }
        },
        "type": "object",
        "required": [
          "url"
        ],
        "title": "WebhookCreateRequest"
      },
      "WebhookFilters": {
        "properties": {
          "event_types": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Types"
          },
          "entity_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entity Ids"
          },
          "min_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Amount"
          }
        },
        "type": "object",
        "title": "WebhookFilters"
      }
    }
  }
}