API Catalog Support

You can discover available HTTP APIs by fetching a standardized RFC 9727 API catalog from the /.well-known/api-catalog endpoint. This exposes a machine-readable linkset that automated clients and orchestration layers can ingest to automatically find available services.

An RFC 9727 linkset JSON catalog is a standardized document format that provides application/linkset+json output. It contains an array of anchor entries with service-desc, service-doc, and status links, enabling automated clients to reliably discover HTTP services without manual endpoint configuration.

To get the OpenAPI schema for Orquestra HTTP services, fetch the API catalog from /.well-known/api-catalog and follow the canonical service description link. This points directly to the authoritative OpenAPI spec at https://api.orquestra.dev/openapi.json for accurate endpoint schemas.

Yes, the API catalog is designed for MCP-ready agent runtimes, orchestration layers, and documentation tooling. It targets automated clients that require linkset-based API discovery and OpenAPI ingestion, providing standardized machine-readable link discovery for ecosystem integration.

The linkset array includes anchor entries with service-desc links pointing to the canonical OpenAPI URL, service-doc links for documentation, and status links. This provides automated clients with all necessary references for ingesting and understanding available HTTP services.