Public API documentation

This site exposes a small, read-only JSON surface intended for agent discovery and lightweight integrations.

Resources

/api/profile.json — public portfolio metadata and section summaries
/api/health.json — static health/status document
/api/openapi.json — OpenAPI 3.1 description of the public endpoints
/.well-known/api-catalog — API catalog in linkset JSON format

Authentication

Discovery metadata is published for OAuth 2.0 and OpenID Connect:

/.well-known/oauth-authorization-server
/.well-known/openid-configuration
/.well-known/oauth-protected-resource
/.well-known/jwks.json

The public portfolio endpoints remain readable without auth on this static deployment. If you later protect APIs behind an authorization server, keep these well-known documents aligned with your live OAuth/OIDC endpoints.

Example response

{
  "status": "ok",
  "service": "portfolio-api",
  "public": true
}