Public API documentation

LobbyStack exposes a small public discovery surface so agents can find documentation, status, OpenAPI metadata, skills, and machine-readable usage preferences without scraping the site.

These public discovery endpoints do not require authentication. OAuth metadata will be published on the app host when protected APIs expose real authorization endpoints.

Who this discovery surface is for

These endpoints help developers, search engines, AI agents, feed readers, and integration tools identify LobbyStack's public documentation and machine-readable product resources. They are discovery interfaces, not an authenticated control plane for customer calls or accounts.

Access and response behavior

  • • Public discovery endpoints accept unauthenticated GET or HEAD requests.
  • • The status endpoint reports public service health; it does not expose tenant or operational data.
  • • Protected application APIs are documented separately and require the authentication method published by the application host.
  • • The homepage supports Accept: text/markdown negotiation; other published Markdown representations are available at the .md endpoints listed below.

Discovery endpoints

EndpointContent typePurpose
/.well-known/api-catalogapplication/linkset+jsonAPI catalog linkset.
/openapi.jsonapplication/vnd.oai.openapi+jsonOpenAPI service description.
/llms.txttext/plainCompact product, feature, pricing, and discovery context for LLMs.
/feed.xmlapplication/rss+xmlFull-content RSS feed for blog discovery.
/schemamap.xmlapplication/xmlStructured-data endpoint discovery map.
/schema/page.jsonapplication/ld+jsonJSON-LD graph for public pages.
/schema/post.jsonapplication/ld+jsonJSON-LD graph for blog posts.
/index.mdtext/markdownHomepage summary in markdown.
/features.mdtext/markdownFeature summary in markdown.
/pricing.mdtext/markdownPricing, included usage, usage rules, and overage rates in markdown.
/.well-known/agent-skills/index.jsonapplication/jsonAgent skills discovery index.
/.well-known/mcp/server-card.jsonapplication/jsonMCP server card.

Request examples

Homepage Markdown negotiation

curl https://lobbystack.com/ \
  -H "Accept: text/markdown"

API catalog

curl https://lobbystack.com/.well-known/api-catalog \
  -H "Accept: application/linkset+json"

Related resources