{
  "openapi": "3.1.0",
  "info": {
    "title": "AIStatusDashboard Public API",
    "version": "1.0.0",
    "description": "Read-only API for provider status, incidents, metrics, and recommendations. All responses include request_id, generated_at, evidence, and confidence.",
    "contact": {
      "email": "hello@aistatusdashboard.com",
      "url": "https://aistatusdashboard.com"
    },
    "termsOfService": "https://aistatusdashboard.com/terms"
  },
  "servers": [
    {
      "url": "https://aistatusdashboard.com"
    }
  ],
  "paths": {
    "/api/public/v1/providers": {
      "get": {
        "operationId": "listProviders",
        "summary": "List providers",
        "description": "Return the list of provider IDs with display names and status URLs.",
        "responses": {
          "200": {
            "description": "Providers list",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Provider"
                          }
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "example": {
                    "summary": "Providers list",
                    "value": {
                      "request_id": "req_providers_2468",
                      "generated_at": "2026-01-17T00:03:00Z",
                      "evidence": [],
                      "confidence": 1,
                      "data": [
                        {
                          "id": "openai",
                          "name": "OpenAI",
                          "display_name": "OpenAI",
                          "category": "AI Provider",
                          "status_url": "https://status.openai.com",
                          "status_page_url": "https://status.openai.com"
                        },
                        {
                          "id": "anthropic",
                          "name": "Anthropic",
                          "display_name": "Claude (Anthropic)",
                          "category": "AI Provider",
                          "status_url": "https://status.anthropic.com",
                          "status_page_url": "https://status.anthropic.com"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/providers/{provider}/surfaces": {
      "get": {
        "operationId": "listProviderSurfaces",
        "summary": "List provider surfaces",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Provider surfaces",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "type": "object",
                          "properties": {
                            "provider_id": {
                              "type": "string"
                            },
                            "surfaces": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "audio",
                                  "chat",
                                  "completion",
                                  "embed",
                                  "embeddings",
                                  "guardrails",
                                  "hub",
                                  "image",
                                  "images",
                                  "inference",
                                  "messages",
                                  "moderation",
                                  "rerank",
                                  "search",
                                  "spaces",
                                  "status",
                                  "train",
                                  "video",
                                  "vision"
                                ]
                              }
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/providers/{provider}/regions": {
      "get": {
        "operationId": "listProviderRegions",
        "summary": "List provider regions",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Provider regions",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "type": "object",
                          "properties": {
                            "provider_id": {
                              "type": "string"
                            },
                            "regions": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "eastus",
                                  "eu-west",
                                  "eu-west-1",
                                  "global",
                                  "us-central",
                                  "us-east",
                                  "us-east-1",
                                  "us-west",
                                  "us-west-2",
                                  "westeurope",
                                  "westus"
                                ]
                              }
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/providers/{provider}/models": {
      "get": {
        "operationId": "listProviderModels",
        "summary": "List provider models",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Provider models",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "type": "object",
                          "properties": {
                            "provider_id": {
                              "type": "string"
                            },
                            "models": {
                              "type": "array",
                              "items": {
                                "type": "object"
                              }
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/status/summary": {
      "get": {
        "operationId": "getStatusSummary",
        "summary": "Get status summary",
        "parameters": [
          {
            "name": "provider",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          },
          {
            "name": "lens",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "official",
                "observed",
                "synthetic",
                "crowd",
                "my_org"
              ]
            }
          },
          {
            "name": "surface",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "audio",
                "chat",
                "completion",
                "embed",
                "embeddings",
                "guardrails",
                "hub",
                "image",
                "images",
                "inference",
                "messages",
                "moderation",
                "rerank",
                "search",
                "spaces",
                "status",
                "train",
                "video",
                "vision"
              ]
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "eastus",
                "eu-west",
                "eu-west-1",
                "global",
                "us-central",
                "us-east",
                "us-east-1",
                "us-west",
                "us-west-2",
                "westeurope",
                "westus"
              ]
            }
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "cerebras-chat",
                "claude-3-haiku-20240307",
                "claude-3-opus-20240229",
                "claude-3-sonnet",
                "claude-3-sonnet-20240229",
                "command-r",
                "command-r-plus",
                "deepseek-chat",
                "deepseek-reasoner",
                "embed-english",
                "gemini-1.0-pro",
                "gemini-1.5-flash",
                "gemini-1.5-pro",
                "gpt-3.5-turbo",
                "gpt-4-turbo",
                "gpt-4.1",
                "gpt-4o",
                "gpt-4o-mini",
                "grok-1.5-latest",
                "grok-2-latest",
                "image-generation",
                "inference-endpoint",
                "jamba",
                "jurassic",
                "llama-3-70b",
                "llama-chat",
                "llama-embed",
                "llama3-70b-8192",
                "llama3-8b-8192",
                "mistral-large-latest",
                "mistral-medium-latest",
                "mistral-small-latest",
                "pro",
                "replicate-run",
                "search",
                "text-embedding-3-large",
                "video-generation"
              ]
            }
          },
          {
            "name": "window_seconds",
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Status summary",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/StatusSummary"
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "summary": {
                    "summary": "Observed status summary (30m window)",
                    "value": {
                      "request_id": "req_status_12345",
                      "generated_at": "2026-01-17T00:00:00Z",
                      "evidence": [],
                      "confidence": 0.92,
                      "data": {
                        "window_seconds": 1800,
                        "lens": "observed",
                        "totals": {
                          "total": 18,
                          "operational": 16,
                          "degraded": 1,
                          "down": 0,
                          "maintenance": 0,
                          "unknown": 1
                        },
                        "providers": [
                          {
                            "provider_id": "openai",
                            "name": "OpenAI",
                            "display_name": "OpenAI",
                            "status": "operational",
                            "description": "All systems operational",
                            "last_updated": "2026-01-17T00:00:00Z",
                            "active_incident_count": 0,
                            "active_maintenance_count": 0,
                            "degraded_component_count": 0,
                            "source": "official"
                          },
                          {
                            "provider_id": "anthropic",
                            "name": "Anthropic",
                            "display_name": "Claude (Anthropic)",
                            "status": "degraded",
                            "description": "Elevated errors on some models",
                            "last_updated": "2026-01-17T00:02:00Z",
                            "active_incident_count": 1,
                            "active_maintenance_count": 0,
                            "degraded_component_count": 1,
                            "source": "official"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/status/health-matrix": {
      "get": {
        "operationId": "getHealthMatrix",
        "summary": "Get health matrix",
        "parameters": [
          {
            "name": "provider",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          },
          {
            "name": "lens",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "observed",
                "synthetic",
                "crowd",
                "my_org"
              ]
            }
          },
          {
            "name": "window_seconds",
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Health matrix",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/HealthMatrix"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/incidents": {
      "get": {
        "operationId": "listIncidents",
        "summary": "Search incidents",
        "parameters": [
          {
            "name": "provider",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          },
          {
            "name": "severity",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "active_only",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "since",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "until",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "eastus",
                "eu-west",
                "eu-west-1",
                "global",
                "us-central",
                "us-east",
                "us-east-1",
                "us-west",
                "us-west-2",
                "westeurope",
                "westus"
              ]
            }
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "cerebras-chat",
                "claude-3-haiku-20240307",
                "claude-3-opus-20240229",
                "claude-3-sonnet",
                "claude-3-sonnet-20240229",
                "command-r",
                "command-r-plus",
                "deepseek-chat",
                "deepseek-reasoner",
                "embed-english",
                "gemini-1.0-pro",
                "gemini-1.5-flash",
                "gemini-1.5-pro",
                "gpt-3.5-turbo",
                "gpt-4-turbo",
                "gpt-4.1",
                "gpt-4o",
                "gpt-4o-mini",
                "grok-1.5-latest",
                "grok-2-latest",
                "image-generation",
                "inference-endpoint",
                "jamba",
                "jurassic",
                "llama-3-70b",
                "llama-chat",
                "llama-embed",
                "llama3-70b-8192",
                "llama3-8b-8192",
                "mistral-large-latest",
                "mistral-medium-latest",
                "mistral-small-latest",
                "pro",
                "replicate-run",
                "search",
                "text-embedding-3-large",
                "video-generation"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Incident list",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "type": "object",
                          "properties": {
                            "incidents": {
                              "type": "array",
                              "items": {
                                "$ref": "#/components/schemas/Incident"
                              }
                            },
                            "next_cursor": {
                              "type": "string",
                              "nullable": true
                            }
                          }
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "example": {
                    "summary": "Recent incidents",
                    "value": {
                      "request_id": "req_inc_98765",
                      "generated_at": "2026-01-17T00:05:00Z",
                      "evidence": [],
                      "confidence": 0.9,
                      "data": {
                        "incidents": [
                          {
                            "incident_id": "openai-2026-01-17-001",
                            "providerId": "openai",
                            "id": "openai-2026-01-17-001",
                            "title": "Elevated error rates on ChatGPT",
                            "status": "resolved",
                            "severity": "degraded",
                            "startedAt": "2026-01-17T00:00:00Z",
                            "updatedAt": "2026-01-17T00:10:00Z",
                            "resolvedAt": "2026-01-17T00:12:00Z",
                            "impactedRegions": [
                              "global"
                            ],
                            "impactedModels": [
                              "gpt-4o"
                            ],
                            "rawUrl": "https://status.openai.com/incidents/abc123",
                            "permalink": "https://aistatusdashboard.com/incidents/openai-2026-01-17-001",
                            "updates": []
                          }
                        ],
                        "next_cursor": null
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/incidents/{incident_id}": {
      "get": {
        "operationId": "getIncident",
        "summary": "Fetch incident",
        "parameters": [
          {
            "name": "incident_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Incident detail",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/Incident"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/metrics": {
      "get": {
        "operationId": "queryMetrics",
        "summary": "Query metrics",
        "parameters": [
          {
            "name": "metric",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "latency_p50_ms",
                "latency_p95_ms",
                "latency_p99_ms",
                "first_token_latency_ms",
                "http_429_rate",
                "http_5xx_rate",
                "tokens_per_sec",
                "stream_disconnect_rate"
              ]
            }
          },
          {
            "name": "provider",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "ai21",
                "anthropic",
                "aws",
                "azure",
                "cerebras",
                "cohere",
                "deepseek",
                "google-ai",
                "groq",
                "huggingface",
                "meta",
                "mistral",
                "openai",
                "perplexity",
                "replicate",
                "runway",
                "stability",
                "xai"
              ]
            }
          },
          {
            "name": "surface",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "audio",
                "chat",
                "completion",
                "embed",
                "embeddings",
                "guardrails",
                "hub",
                "image",
                "images",
                "inference",
                "messages",
                "moderation",
                "rerank",
                "search",
                "spaces",
                "status",
                "train",
                "video",
                "vision"
              ]
            }
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "cerebras-chat",
                "claude-3-haiku-20240307",
                "claude-3-opus-20240229",
                "claude-3-sonnet",
                "claude-3-sonnet-20240229",
                "command-r",
                "command-r-plus",
                "deepseek-chat",
                "deepseek-reasoner",
                "embed-english",
                "gemini-1.0-pro",
                "gemini-1.5-flash",
                "gemini-1.5-pro",
                "gpt-3.5-turbo",
                "gpt-4-turbo",
                "gpt-4.1",
                "gpt-4o",
                "gpt-4o-mini",
                "grok-1.5-latest",
                "grok-2-latest",
                "image-generation",
                "inference-endpoint",
                "jamba",
                "jurassic",
                "llama-3-70b",
                "llama-chat",
                "llama-embed",
                "llama3-70b-8192",
                "llama3-8b-8192",
                "mistral-large-latest",
                "mistral-medium-latest",
                "mistral-small-latest",
                "pro",
                "replicate-run",
                "search",
                "text-embedding-3-large",
                "video-generation"
              ]
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "eastus",
                "eu-west",
                "eu-west-1",
                "global",
                "us-central",
                "us-east",
                "us-east-1",
                "us-west",
                "us-west-2",
                "westeurope",
                "westus"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "until",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "granularity_seconds",
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Metric series",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/MetricSeries"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/recommendations/fallback_plan": {
      "post": {
        "operationId": "getFallbackPlan",
        "summary": "Generate fallback plan",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "enum": [
                      "ai21",
                      "anthropic",
                      "aws",
                      "azure",
                      "cerebras",
                      "cohere",
                      "deepseek",
                      "google-ai",
                      "groq",
                      "huggingface",
                      "meta",
                      "mistral",
                      "openai",
                      "perplexity",
                      "replicate",
                      "runway",
                      "stability",
                      "xai"
                    ]
                  },
                  "model": {
                    "type": "string",
                    "enum": [
                      "cerebras-chat",
                      "claude-3-haiku-20240307",
                      "claude-3-opus-20240229",
                      "claude-3-sonnet",
                      "claude-3-sonnet-20240229",
                      "command-r",
                      "command-r-plus",
                      "deepseek-chat",
                      "deepseek-reasoner",
                      "embed-english",
                      "gemini-1.0-pro",
                      "gemini-1.5-flash",
                      "gemini-1.5-pro",
                      "gpt-3.5-turbo",
                      "gpt-4-turbo",
                      "gpt-4.1",
                      "gpt-4o",
                      "gpt-4o-mini",
                      "grok-1.5-latest",
                      "grok-2-latest",
                      "image-generation",
                      "inference-endpoint",
                      "jamba",
                      "jurassic",
                      "llama-3-70b",
                      "llama-chat",
                      "llama-embed",
                      "llama3-70b-8192",
                      "llama3-8b-8192",
                      "mistral-large-latest",
                      "mistral-medium-latest",
                      "mistral-small-latest",
                      "pro",
                      "replicate-run",
                      "search",
                      "text-embedding-3-large",
                      "video-generation"
                    ]
                  },
                  "endpoint": {
                    "type": "string",
                    "enum": [
                      "audio",
                      "chat",
                      "completion",
                      "embed",
                      "embeddings",
                      "guardrails",
                      "hub",
                      "image",
                      "images",
                      "inference",
                      "messages",
                      "moderation",
                      "rerank",
                      "search",
                      "spaces",
                      "status",
                      "train",
                      "video",
                      "vision"
                    ]
                  },
                  "region": {
                    "type": "string",
                    "enum": [
                      "eastus",
                      "eu-west",
                      "eu-west-1",
                      "global",
                      "us-central",
                      "us-east",
                      "us-east-1",
                      "us-west",
                      "us-west-2",
                      "westeurope",
                      "westus"
                    ]
                  },
                  "tier": {
                    "type": "string"
                  },
                  "streaming": {
                    "type": "boolean"
                  },
                  "signal": {
                    "type": "string"
                  },
                  "latency_p50_ms": {
                    "type": "number"
                  },
                  "latency_p95_ms": {
                    "type": "number"
                  },
                  "latency_p99_ms": {
                    "type": "number"
                  },
                  "http_5xx_rate": {
                    "type": "number"
                  },
                  "http_429_rate": {
                    "type": "number"
                  },
                  "tokens_per_sec": {
                    "type": "number"
                  },
                  "stream_disconnect_rate": {
                    "type": "number"
                  }
                },
                "required": [
                  "model",
                  "endpoint",
                  "region"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Fallback plan",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/FallbackPlan"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/policy/generate": {
      "post": {
        "operationId": "generatePolicy",
        "summary": "Generate routing policy",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "enum": [
                      "ai21",
                      "anthropic",
                      "aws",
                      "azure",
                      "cerebras",
                      "cohere",
                      "deepseek",
                      "google-ai",
                      "groq",
                      "huggingface",
                      "meta",
                      "mistral",
                      "openai",
                      "perplexity",
                      "replicate",
                      "runway",
                      "stability",
                      "xai"
                    ]
                  },
                  "model": {
                    "type": "string",
                    "enum": [
                      "cerebras-chat",
                      "claude-3-haiku-20240307",
                      "claude-3-opus-20240229",
                      "claude-3-sonnet",
                      "claude-3-sonnet-20240229",
                      "command-r",
                      "command-r-plus",
                      "deepseek-chat",
                      "deepseek-reasoner",
                      "embed-english",
                      "gemini-1.0-pro",
                      "gemini-1.5-flash",
                      "gemini-1.5-pro",
                      "gpt-3.5-turbo",
                      "gpt-4-turbo",
                      "gpt-4.1",
                      "gpt-4o",
                      "gpt-4o-mini",
                      "grok-1.5-latest",
                      "grok-2-latest",
                      "image-generation",
                      "inference-endpoint",
                      "jamba",
                      "jurassic",
                      "llama-3-70b",
                      "llama-chat",
                      "llama-embed",
                      "llama3-70b-8192",
                      "llama3-8b-8192",
                      "mistral-large-latest",
                      "mistral-medium-latest",
                      "mistral-small-latest",
                      "pro",
                      "replicate-run",
                      "search",
                      "text-embedding-3-large",
                      "video-generation"
                    ]
                  },
                  "endpoint": {
                    "type": "string",
                    "enum": [
                      "audio",
                      "chat",
                      "completion",
                      "embed",
                      "embeddings",
                      "guardrails",
                      "hub",
                      "image",
                      "images",
                      "inference",
                      "messages",
                      "moderation",
                      "rerank",
                      "search",
                      "spaces",
                      "status",
                      "train",
                      "video",
                      "vision"
                    ]
                  },
                  "region": {
                    "type": "string",
                    "enum": [
                      "eastus",
                      "eu-west",
                      "eu-west-1",
                      "global",
                      "us-central",
                      "us-east",
                      "us-east-1",
                      "us-west",
                      "us-west-2",
                      "westeurope",
                      "westus"
                    ]
                  },
                  "tier": {
                    "type": "string"
                  },
                  "streaming": {
                    "type": "boolean"
                  },
                  "objective": {
                    "type": "string"
                  }
                },
                "required": [
                  "model",
                  "endpoint",
                  "region"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Policy",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/Policy"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/casual/status": {
      "get": {
        "operationId": "getCasualStatus",
        "summary": "Get casual-mode status summary for a consumer app.",
        "parameters": [
          {
            "name": "app",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "window_minutes",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Casual status payload",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CasualStatus"
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "example": {
                    "summary": "Casual mode status for ChatGPT",
                    "value": {
                      "request_id": "req_casual_1357",
                      "generated_at": "2026-01-17T00:04:00Z",
                      "evidence": [],
                      "confidence": 0.86,
                      "data": {
                        "app_id": "chatgpt",
                        "app_name": "ChatGPT",
                        "provider_id": "openai",
                        "overall_status": "degraded",
                        "headline": "You may see delays or retries right now.",
                        "symptoms": [
                          "Requests may fail",
                          "Responses can be slow"
                        ],
                        "actions": [
                          "Wait 10–30 minutes",
                          "Try a lighter model"
                        ],
                        "confidence": 0.86,
                        "updated_at": "2026-01-17T00:04:00Z",
                        "surfaces": [
                          {
                            "id": "text",
                            "label": "Text",
                            "status": "degraded",
                            "headline": "Text responses may be slow.",
                            "symptoms": [
                              "Long loading",
                              "Occasional errors"
                            ],
                            "actions": [
                              "Refresh once",
                              "Retry in a few minutes"
                            ],
                            "confidence": 0.8,
                            "updated_at": "2026-01-17T00:04:00Z",
                            "evidence": []
                          }
                        ],
                        "is_it_just_me": {
                          "window_minutes": 10,
                          "reports": 42,
                          "likely_global": true,
                          "baseline_per_10m": 6,
                          "top_regions": [
                            {
                              "region": "US",
                              "count": 18
                            }
                          ],
                          "note": "Reports exceed baseline across multiple regions."
                        },
                        "history": {
                          "typical_resolution_minutes": 35,
                          "last_similar_event": {
                            "started_at": "2026-01-15T22:00:00Z",
                            "duration_minutes": 28,
                            "permalink": "https://aistatusdashboard.com/incidents/openai-2026-01-15-001"
                          }
                        },
                        "evidence": []
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/casual/reports": {
      "post": {
        "operationId": "postCasualReport",
        "summary": "Submit an anonymous casual-mode user report.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "app",
                  "surface",
                  "issue"
                ],
                "properties": {
                  "app": {
                    "type": "string"
                  },
                  "surface": {
                    "type": "string"
                  },
                  "issue": {
                    "type": "boolean"
                  },
                  "issueType": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "clientType": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Report accepted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Evidence": {
        "type": "object",
        "properties": {
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "metric_window": {
            "type": "object",
            "properties": {
              "since": {
                "type": "string",
                "format": "date-time"
              },
              "until": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "note": {
            "type": "string"
          }
        }
      },
      "ResponseEnvelope": {
        "type": "object",
        "required": [
          "request_id",
          "generated_at",
          "evidence",
          "confidence",
          "data"
        ],
        "properties": {
          "request_id": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "evidence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Evidence"
            }
          },
          "confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "data": {
            "type": "object"
          }
        }
      },
      "Provider": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "ai21",
              "anthropic",
              "aws",
              "azure",
              "cerebras",
              "cohere",
              "deepseek",
              "google-ai",
              "groq",
              "huggingface",
              "meta",
              "mistral",
              "openai",
              "perplexity",
              "replicate",
              "runway",
              "stability",
              "xai"
            ]
          },
          "name": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "status_url": {
            "type": "string",
            "format": "uri"
          },
          "status_page_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "StatusSummary": {
        "type": "object",
        "properties": {
          "window_seconds": {
            "type": "number"
          },
          "lens": {
            "type": "string"
          },
          "totals": {
            "type": "object",
            "properties": {
              "total": {
                "type": "number"
              },
              "operational": {
                "type": "number"
              },
              "degraded": {
                "type": "number"
              },
              "down": {
                "type": "number"
              },
              "maintenance": {
                "type": "number"
              },
              "unknown": {
                "type": "number"
              }
            }
          },
          "providers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "provider_id": {
                  "type": "string",
                  "enum": [
                    "ai21",
                    "anthropic",
                    "aws",
                    "azure",
                    "cerebras",
                    "cohere",
                    "deepseek",
                    "google-ai",
                    "groq",
                    "huggingface",
                    "meta",
                    "mistral",
                    "openai",
                    "perplexity",
                    "replicate",
                    "runway",
                    "stability",
                    "xai"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "display_name": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "last_updated": {
                  "type": "string",
                  "format": "date-time"
                },
                "active_incident_count": {
                  "type": "number"
                },
                "active_maintenance_count": {
                  "type": "number"
                },
                "degraded_component_count": {
                  "type": "number"
                },
                "source": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "HealthMatrix": {
        "type": "object",
        "properties": {
          "provider_id": {
            "type": "string",
            "enum": [
              "ai21",
              "anthropic",
              "aws",
              "azure",
              "cerebras",
              "cohere",
              "deepseek",
              "google-ai",
              "groq",
              "huggingface",
              "meta",
              "mistral",
              "openai",
              "perplexity",
              "replicate",
              "runway",
              "stability",
              "xai"
            ]
          },
          "window_seconds": {
            "type": "number"
          },
          "lens": {
            "type": "string"
          },
          "tiles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "providerId": {
                  "type": "string"
                },
                "model": {
                  "type": "string",
                  "enum": [
                    "cerebras-chat",
                    "claude-3-haiku-20240307",
                    "claude-3-opus-20240229",
                    "claude-3-sonnet",
                    "claude-3-sonnet-20240229",
                    "command-r",
                    "command-r-plus",
                    "deepseek-chat",
                    "deepseek-reasoner",
                    "embed-english",
                    "gemini-1.0-pro",
                    "gemini-1.5-flash",
                    "gemini-1.5-pro",
                    "gpt-3.5-turbo",
                    "gpt-4-turbo",
                    "gpt-4.1",
                    "gpt-4o",
                    "gpt-4o-mini",
                    "grok-1.5-latest",
                    "grok-2-latest",
                    "image-generation",
                    "inference-endpoint",
                    "jamba",
                    "jurassic",
                    "llama-3-70b",
                    "llama-chat",
                    "llama-embed",
                    "llama3-70b-8192",
                    "llama3-8b-8192",
                    "mistral-large-latest",
                    "mistral-medium-latest",
                    "mistral-small-latest",
                    "pro",
                    "replicate-run",
                    "search",
                    "text-embedding-3-large",
                    "video-generation"
                  ]
                },
                "endpoint": {
                  "type": "string",
                  "enum": [
                    "audio",
                    "chat",
                    "completion",
                    "embed",
                    "embeddings",
                    "guardrails",
                    "hub",
                    "image",
                    "images",
                    "inference",
                    "messages",
                    "moderation",
                    "rerank",
                    "search",
                    "spaces",
                    "status",
                    "train",
                    "video",
                    "vision"
                  ]
                },
                "region": {
                  "type": "string",
                  "enum": [
                    "eastus",
                    "eu-west",
                    "eu-west-1",
                    "global",
                    "us-central",
                    "us-east",
                    "us-east-1",
                    "us-west",
                    "us-west-2",
                    "westeurope",
                    "westus"
                  ]
                },
                "tier": {
                  "type": "string"
                },
                "streaming": {
                  "type": "boolean"
                },
                "latencyP50": {
                  "type": "number"
                },
                "latencyP95": {
                  "type": "number"
                },
                "latencyP99": {
                  "type": "number"
                },
                "http5xxRate": {
                  "type": "number"
                },
                "http429Rate": {
                  "type": "number"
                },
                "tokensPerSec": {
                  "type": "number"
                },
                "streamDisconnectRate": {
                  "type": "number"
                },
                "signal": {
                  "type": "string"
                },
                "confidence": {
                  "type": "string"
                },
                "evidence": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "Incident": {
        "type": "object",
        "properties": {
          "incident_id": {
            "type": "string"
          },
          "providerId": {
            "type": "string",
            "enum": [
              "ai21",
              "anthropic",
              "aws",
              "azure",
              "cerebras",
              "cohere",
              "deepseek",
              "google-ai",
              "groq",
              "huggingface",
              "meta",
              "mistral",
              "openai",
              "perplexity",
              "replicate",
              "runway",
              "stability",
              "xai"
            ]
          },
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "resolvedAt": {
            "type": "string",
            "format": "date-time"
          },
          "impactedRegions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "impactedModels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "rawUrl": {
            "type": "string",
            "format": "uri"
          },
          "permalink": {
            "type": "string"
          },
          "updates": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      },
      "MetricSeries": {
        "type": "object",
        "properties": {
          "metric": {
            "type": "string",
            "enum": [
              "latency_p50_ms",
              "latency_p95_ms",
              "latency_p99_ms",
              "first_token_latency_ms",
              "http_429_rate",
              "http_5xx_rate",
              "tokens_per_sec",
              "stream_disconnect_rate"
            ]
          },
          "provider_id": {
            "type": "string",
            "enum": [
              "ai21",
              "anthropic",
              "aws",
              "azure",
              "cerebras",
              "cohere",
              "deepseek",
              "google-ai",
              "groq",
              "huggingface",
              "meta",
              "mistral",
              "openai",
              "perplexity",
              "replicate",
              "runway",
              "stability",
              "xai"
            ]
          },
          "surface": {
            "type": "string",
            "enum": [
              "audio",
              "chat",
              "completion",
              "embed",
              "embeddings",
              "guardrails",
              "hub",
              "image",
              "images",
              "inference",
              "messages",
              "moderation",
              "rerank",
              "search",
              "spaces",
              "status",
              "train",
              "video",
              "vision"
            ]
          },
          "model": {
            "type": "string",
            "enum": [
              "cerebras-chat",
              "claude-3-haiku-20240307",
              "claude-3-opus-20240229",
              "claude-3-sonnet",
              "claude-3-sonnet-20240229",
              "command-r",
              "command-r-plus",
              "deepseek-chat",
              "deepseek-reasoner",
              "embed-english",
              "gemini-1.0-pro",
              "gemini-1.5-flash",
              "gemini-1.5-pro",
              "gpt-3.5-turbo",
              "gpt-4-turbo",
              "gpt-4.1",
              "gpt-4o",
              "gpt-4o-mini",
              "grok-1.5-latest",
              "grok-2-latest",
              "image-generation",
              "inference-endpoint",
              "jamba",
              "jurassic",
              "llama-3-70b",
              "llama-chat",
              "llama-embed",
              "llama3-70b-8192",
              "llama3-8b-8192",
              "mistral-large-latest",
              "mistral-medium-latest",
              "mistral-small-latest",
              "pro",
              "replicate-run",
              "search",
              "text-embedding-3-large",
              "video-generation"
            ]
          },
          "region": {
            "type": "string",
            "enum": [
              "eastus",
              "eu-west",
              "eu-west-1",
              "global",
              "us-central",
              "us-east",
              "us-east-1",
              "us-west",
              "us-west-2",
              "westeurope",
              "westus"
            ]
          },
          "tier": {
            "type": "string"
          },
          "streaming": {
            "type": "boolean"
          },
          "since": {
            "type": "string",
            "format": "date-time"
          },
          "until": {
            "type": "string",
            "format": "date-time"
          },
          "granularity_seconds": {
            "type": "number"
          },
          "series": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "timestamp": {
                  "type": "string",
                  "format": "date-time"
                },
                "value": {
                  "type": "number",
                  "nullable": true
                },
                "sample_count": {
                  "type": "number"
                },
                "sources": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      },
      "FallbackPlan": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "string"
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "jsonPolicy": {
            "type": "object"
          },
          "evidence": {
            "type": "object"
          }
        }
      },
      "Policy": {
        "type": "object",
        "properties": {
          "policy_id": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "objective": {
            "type": "string"
          },
          "rules": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      },
      "CasualStatus": {
        "type": "object",
        "properties": {
          "app_id": {
            "type": "string"
          },
          "app_name": {
            "type": "string"
          },
          "provider_id": {
            "type": "string"
          },
          "overall_status": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "symptoms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "confidence": {
            "type": "number"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "surfaces": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "headline": {
                  "type": "string"
                },
                "symptoms": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "actions": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "confidence": {
                  "type": "number"
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "evidence": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          },
          "is_it_just_me": {
            "type": "object",
            "properties": {
              "window_minutes": {
                "type": "number"
              },
              "reports": {
                "type": "number"
              },
              "likely_global": {
                "type": "boolean"
              },
              "baseline_per_10m": {
                "type": "number"
              },
              "top_regions": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "note": {
                "type": "string"
              }
            }
          },
          "history": {
            "type": "object"
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "API documentation",
    "url": "https://aistatusdashboard.com/docs/api.md"
  }
}