This page documents the public API surface for
resume.thewise.cloud and serves as the
service-doc target referenced from
/.well-known/api-catalog.
| URL | Purpose | Type |
|---|---|---|
| /sitemap.xml | Canonical public URLs | application/xml |
| /robots.txt | Crawler rules + Content Signals | text/plain |
| /.well-known/api-catalog | RFC 9727 link set | application/linkset+json |
| /.well-known/openid-configuration | OIDC issuer (delegates to Kinde) | application/json |
| /.well-known/oauth-authorization-server | OAuth 2.0 AS metadata | application/json |
| /.well-known/oauth-protected-resource | RFC 9728 protected resource metadata | application/json |
| /.well-known/mcp/server-card.json | MCP server card (SEP-1649) | application/json |
| /.well-known/agent-skills/index.json | Agent Skills index (v0.2.0) | application/json |
Authentication is provided by Kinde
(issuer https://thewisecloud.kinde.com) via OAuth 2.0 / OIDC.
Kinde-issued JWTs are exchanged server-side for Supabase-scoped tokens by the
token-exchange edge function. Authenticated calls to the API
MUST include a Authorization: Bearer <jwt> header.
GET /api/healthLiveness probe. Returns { "status": "ok", "timestamp": "..." }.
GET /api/db-healthDatabase connectivity probe. Returns { "status": "ok" } on success.
ALL /api/fn/:fnName
Server-side proxy that forwards the request body, query string, and
Authorization header to the matching Supabase Edge Function
https://<project>.supabase.co/functions/v1/:fnName.
The Supabase project anon key is injected by the proxy and never leaves the server.
Response status, body, and Content-Type are forwarded verbatim.
The full set of available :fnName values is enumerated under
supabase/functions/ in the source tree. Common public-surface
functions include token-exchange, ai-health,
portfolio-public-get, contact-form, and
waitlist-signup.
All HTML pages on this origin honor the Accept: text/markdown
content-negotiation header. Sending that header returns a markdown
rendering of the same page with Content-Type: text/markdown,
suitable for ingestion into LLM agents. Browsers continue to receive HTML.
The landing page registers a small set of in-page tools via
navigator.modelContext.provideContext() for WebMCP-aware
agents. Tools currently registered include open_pricing,
open_examples, and start_resume.
For partnership or integration questions, email contact@thewise.cloud.