api-endpoint

# api-endpoint > **Grounded corpus:** endpoint-shape decisions (pagination, error shape, > idempotency, rate limits) ground via the > [`api-design`](../api-design/SKILL.md) corpus — `./scripts-run > <skills-root>/corpus-grounding/scripts/ground search > --manifest <skills-root>/api-design/data/manifest.json "<concern>"`. ## When to use Use this skill when the user asks to create a new API endpoint, REST route, or HTTP handler. Do NOT use when: - Modifying existing endpoints — use the code-refactoring skill. - API design decisions (versioning, deprecation, contract shape) — use [`api-design`](../api-design/SKILL.md). ## Stack routing Detect the stack, then hand off to the matching carve-out skill for the framework-specific procedure (file layout, validation primitive, response-shaping convention). | Detected stack | Carve-out skill | |---|---| | Laravel (`artisan` + `composer.json` with `laravel/framework`) | [`laravel-api-endpoint`](../laravel-api-endpoint/SKILL.md) | | Symfony (`bin/console` + `composer.json` with `symfony/framework-bundle`) | [`symfony-workflow`](../symfony-workflow/SKILL.md) | | Next.js (`next` in `package.json`) | [`nextjs-patterns`](../nextjs-patterns/SKILL.md) | | Express / Fastify / NestJS / plain Node | follow project conventions in `agents/` + `package.json scripts` | | FastAPI / Django / Flask | follow project conventions in `agents/` + `pyproject.toml` | | Go (`net/http`, `gin`, `echo`, `fiber`) | follow project conventions in `agents/` + `...