Core API Overview

Every endpoint below lives under https://app.swayzio.com/api/swayzio/v1 unless noted. All product routes require a Clerk actor; public share surfaces and webhooks are the exceptions.

Resources

Conventions used in these pages

• Auth — every endpoint states its requirement: Public, Clerk actor, + entitlement, Internal secret, or Webhook signature.
• Request / Response — names refer to Zod schemas in @swayzio/domain; see Data Contracts for field‑level detail and the client*/public* redaction pattern.
• Runtime — native→proxy means the route is served natively on Vercel and falls back to the Fastify Core API when not running natively; native only means it never proxies. See Architecture.
• Stub / placeholder endpoints are flagged inline.