OpenAPI Discovery (.well-known/openapi)

As part of OAS-63-002 the platform exposes a discovery document at:

/.well-known/openapi → JSON body:

{
  "spec": "/stella.yaml",
  "version": "v1",
  "generatedAt": "<RFC3339>",
  "extensions": {
    "x-stellaops-profile": "aggregate",
    "x-stellaops-schemaVersion": "1.0.0"
  }
}

Contracts:

spec is a relative URL to the aggregate OpenAPI (stella.yaml).
version denotes the discovery doc version; defaults to v1.
generatedAt is the UTC timestamp when the aggregate spec was built.
extensions carries optional metadata for downstream tooling.

Implementations (API Gateway / Console) should cache the response with Cache-Control: max-age=300 and serve it alongside the aggregate spec artifact produced by the OAS CI workflow.

836 B Raw Blame History

OpenAPI Discovery (.well-known/openapi)

836 B

Raw Blame History