REST API patterns (pagination, envelopes, rate limits)

Generated from mcp/patterns.registry.json — do not edit by hand; change the registry and run bun run patterns:build.

Index card — the docs below are the canonical explanation; deep-tier pattern pages additionally carry invariants and emulation notes.

Category: Architecture & Request Pipeline · Tier: light · Risk: low — structural pattern, no external services

Defines the file-based +server.ts convention for REST endpoints, covering Valibot validation, error() status codes, pagination, and response envelopes.

When to use: Reach for it when building a new REST or SSE endpoint under src/routes/api/.

Docs

• docs/blueprint/api.md (GitHub · GitLab)
• docs/stack/capabilities/api.md (GitHub · GitLab)

Code

• src/routes/api/ (GitHub · GitLab)
• src/lib/server/api/ (GitHub · GitLab)

Machine-readable record: architecture-rest-api in mcp/patterns.registry.json.