API Design Architect

Designs RESTful and GraphQL APIs following industry best practices for resource modeling, versioning, error handling, pagination, authentication, and OpenAPI specification.

Gold

v1.0.01 activationsSoftware EngineeringEngineeringadvanced

SupaScore

Research Quality (15%)

8.5

Prompt Engineering (25%)

Practical Utility (15%)

8.5

Completeness (10%)

8.5

User Satisfaction (20%)

7.5

Decision Usefulness (15%)

Best for

▸Design RESTful APIs for microservices with proper resource modeling and HTTP semantics
▸Create GraphQL schemas with efficient resolver patterns and N+1 problem prevention
▸Generate complete OpenAPI 3.1 specifications with authentication schemes and examples
▸Design API versioning strategies and backward compatibility migration paths
▸Architect API authentication flows using OAuth 2.0, JWT tokens, and PKCE

What you'll get

●Complete REST API specification with resource URIs, HTTP methods, status codes, request/response schemas, and error response format following JSON:API conventions
●GraphQL schema definition with types, queries, mutations, and resolver architecture addressing N+1 problems through batching strategies
●OpenAPI 3.1 YAML specification with security schemes, parameter definitions, example requests/responses, and comprehensive endpoint documentation

Not designed for ↓

×Implementation of API code in specific programming languages or frameworks
×Database schema design or data modeling beyond API resource representation
×DevOps deployment and infrastructure setup for APIs
×UI/UX design for developer portals or API documentation websites

Expects

Clear business requirements including resources, relationships, user roles, and technical constraints like performance needs or existing system integration points.

Returns

Complete API specification with endpoint definitions, request/response schemas, error handling patterns, authentication flows, and OpenAPI documentation ready for implementation.

Evidence Policy

Enabled: this skill cites sources and distinguishes evidence from opinion.

api-designrestgraphqlopenapiarchitecturehttpversioning

Research Foundation: 6 sources (1 academic, 4 official docs, 1 books)

This skill was developed through independent research and synthesis. SupaSkills is not affiliated with or endorsed by any cited author or organisation.

Version History

v1.0.02/14/2026

Initial version

Works well with

API Documentation WriterGold API Performance Testing ExpertGold API Security HardenerGold Authentication & Authorization ArchitectGold Database Design AdvisorPlatinum

Need more depth?

Specialist skills that go deeper in areas this skill touches.

API Lifecycle Management ExpertGold API Gateway Pattern ArchitectGold GraphQL API DesignerGold

Common Workflows

Complete API Development Lifecycle

End-to-end API development from design through security hardening, documentation, and performance validation

api-design-architect→API Security Hardener→API Documentation Writer→API Performance Testing Expert

Activate this skill in Claude Code

Start Free to Activate This Skill