{"openapi":"3.2.0","info":{"title":"XaaS Catalog API","version":"0.0.0","description":"The VeloxAI managed-service catalog: one public directory for every Everything-as-a-Service product, with shared positioning, links, and a single contract surface for discovery."},"servers":[{"url":"https://xaas.velox.ai","description":"Production"}],"tags":[{"name":"operations","description":"Health and readiness"},{"name":"catalog","description":"Managed-service directory"}],"paths":{"/health":{"get":{"tags":["operations"],"operationId":"getHealth","summary":"Process health","responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}},"/ready":{"get":{"tags":["operations"],"operationId":"getReady","summary":"Readiness including the static directory","responses":{"200":{"description":"Ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ready"}}}},"503":{"description":"Not ready"}}}},"/v1/product":{"get":{"tags":["catalog"],"operationId":"getProduct","summary":"Catalog descriptor","responses":{"200":{"description":"Catalog descriptor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/v1/catalog":{"get":{"tags":["catalog"],"operationId":"getCatalog","summary":"Catalog descriptor","responses":{"200":{"description":"Catalog descriptor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/v1/products":{"get":{"tags":["catalog"],"operationId":"listProducts","summary":"List managed services","responses":{"200":{"description":"Managed-service entries","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}}}}}}}},"/v1/products/{id}":{"get":{"tags":["catalog"],"operationId":"getProductById","summary":"Get one managed service","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Managed-service entry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSummary"}}}},"404":{"description":"Unknown service","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/capabilities":{"get":{"tags":["catalog"],"operationId":"listCapabilities","summary":"Catalog capabilities","responses":{"200":{"description":"Capability catalog","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Capability"}}}}}}}},"/openapi.json":{"get":{"tags":["operations"],"operationId":"getOpenapiAlias","summary":"OpenAPI contract (compatibility alias)","responses":{"200":{"description":"OpenAPI 3.2 document"}}}},"/.well-known/openapi.json":{"get":{"tags":["operations"],"operationId":"getWellKnownOpenapi","summary":"OpenAPI contract (canonical well-known path)","responses":{"200":{"description":"OpenAPI 3.2 document"}}}}},"components":{"schemas":{"Health":{"type":"object","required":["status","service","version","uptime","checks"],"properties":{"status":{"type":"string","const":"ok"},"service":{"type":"string"},"version":{"type":"string"},"uptime":{"type":"number"},"checks":{"type":"object","additionalProperties":{"type":"string"}}}},"Ready":{"type":"object","required":["status","service","checks"],"properties":{"status":{"type":"string"},"service":{"type":"string"},"checks":{"type":"object","additionalProperties":{"type":"string"}}}},"Capability":{"type":"object","required":["id","name","summary","status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"},"status":{"type":"string"}}},"ProductSummary":{"type":"object","required":["id","name","displayName","domain","url","tagline","summary"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"displayName":{"type":"string"},"domain":{"type":"string"},"url":{"type":"string"},"tagline":{"type":"string"},"summary":{"type":"string"},"accent":{"type":"string"},"accent2":{"type":"string"},"bg":{"type":"string"}}},"Catalog":{"type":"object","required":["id","name","displayName","domain","status","summary","tagline","products","capabilities"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"displayName":{"type":"string"},"domain":{"type":"string"},"status":{"type":"string"},"summary":{"type":"string"},"tagline":{"type":"string"},"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"}}}},"Error":{"type":"object","required":["error","message","requestId"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}}}}}}