What pagination methods are included?

The skill provides patterns for both simple offset-based pagination and high-performance cursor-based pagination for large datasets.

How does it handle multi-tenant security?

It enforces tenant isolation through a repository pattern that automatically filters all database queries based on tenant IDs extracted from JWT claims.

What frameworks does this API design skill support?

This skill is optimized for FastAPI (Python) and TanStack Start (TypeScript) environments, following the Grey Haven architecture standards.

Does it provide support for API documentation?

Yes, it includes standards for auto-generating OpenAPI (Swagger) documentation, including summary tags, detailed descriptions, and response model definitions.

API Design Standards

Name: API Design Standards
Author: greyhaven-ai

bygreyhaven-ai

•

API Development

Standardizes RESTful API development using FastAPI and TanStack Start with a focus on multi-tenant security and Pydantic validation.

About

This skill provides a comprehensive framework for building robust, production-grade APIs within the Grey Haven ecosystem, ensuring consistency across backend services. It enforces best practices for RESTful resource design, automatic OpenAPI documentation, and strict multi-tenant isolation via the repository pattern. Whether you are building FastAPI backends or TanStack Start server functions, this skill guides the implementation of secure authentication, efficient pagination, standardized error handling, and rate limiting to ensure scalable and maintainable codebases.

Key Features

Advanced pagination patterns including offset and cursor-based methods
Automated Pydantic schema generation for validation and response filtering
Strict multi-tenant isolation using repository patterns and JWT claims
15 GitHub stars
Pre-configured error handling and OpenAPI documentation standards
Standardized RESTful resource naming and HTTP verb conventions

Use Cases

Architecting a new FastAPI backend with secure, multi-tenant data access
Standardizing API error responses and validation logic across multiple microservices
Implementing TanStack Start server functions for type-safe full-stack communication

About

Key Features

Advanced pagination patterns including offset and cursor-based methods
Automated Pydantic schema generation for validation and response filtering
Strict multi-tenant isolation using repository patterns and JWT claims
15 GitHub stars
Pre-configured error handling and OpenAPI documentation standards
Standardized RESTful resource naming and HTTP verb conventions

Use Cases

Architecting a new FastAPI backend with secure, multi-tenant data access
Standardizing API error responses and validation logic across multiple microservices
Implementing TanStack Start server functions for type-safe full-stack communication