{"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."},"servers":[{"url":"https://aistatusdashboard.com/api/public/v1","description":"Production"}],"paths":{"/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"}}}}]}}}}}}},"/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"]}}}}}}]}}}}}}},"/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"]}}}}}}]}}}}}}},"/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"}}}}}}]}}}}}}},"/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"}}}]}}}}}}},"/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"}}}]}}}}}}},"/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}}}}}]}}}}}}},"/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"}}}]}}}}}}},"/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"}}}]}}}}}}},"/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"}}}]}}}}}}},"/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"}}}]}}}}}}}},"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"}}}}}}}