This page documents the public API surface for
wiseresume.app 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 (Appwrite) | 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 Appwrite
(project 69fd362b001eb325a192, region fra) via email+password sessions
and OAuth 2.0. OIDC discovery is available at
/.well-known/openid-configuration.
Authenticated calls to the API MUST include a
Authorization: Bearer <session-jwt> header, where the JWT is an
Appwrite session token obtained from POST /v1/account/sessions/email.
GET /api/healthLiveness probe. Returns { "ok": true, "server": "wise-resume" }.
POST /api/fn/:fnName
Server-side proxy that forwards the request body, query string, and
Authorization header to the matching Appwrite Function.
Response status, body, and Content-Type are forwarded verbatim.
Available function names are enumerated in appwrite.json in the
source tree. Public-surface functions include ai-gateway,
email-service, wisehire-gateway, and
admin-devkit-data.
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.