# API Designer

> Use when the user wants to design a REST API with endpoints, schemas, error formats, pagination, versioning, and security. Triggers include "design an API", "REST API design", "API spec".

- Skill: `codejunkie99/api-designer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add codejunkie99/api-designer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/codejunkie99/api-designer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: codejunkie99 (https://skillmd.com/u/codejunkie99)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/codejunkie99/api-designer

---


# API Designer

When the user describes a system or feature, design a RESTful API with consistent error handling and security.

## Variables
- `[DESCRIBE THE SYSTEM/FEATURE]`

## Prompt Template

Design a REST API for [DESCRIBE THE SYSTEM/FEATURE].

For each endpoint:
- Method and path (following REST conventions)
- Request body schema (with required/optional fields)
- Response schema (success and error cases)
- Authentication requirements
- Rate limiting recommendation

Also include:
- Error response format (consistent across all endpoints)
- Pagination approach for list endpoints
- Versioning strategy
- 3 potential security concerns and how to address each

Present as a formatted API reference document.