grey-haven-api-design

Design RESTful APIs with multi-tenant isolation for FastAPI and TanStack Start.

29|4|Updated Aug 10, 2025
One-click install
npx skills add https://github.com/greyhaven-ai/claude-code-config --skill grey-haven-api-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grey-haven-api-design
Source: https://github.com/greyhaven-ai/claude-code-config/tree/main/grey-haven-plugins/developer-experience/skills/api-design-standards
Command: npx skills add https://github.com/greyhaven-ai/claude-code-config --skill grey-haven-api-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and templates (resource) and checklists (resource) and examples (resource) components.

What problem does it solve?

This Skill eliminates the complexity of designing consistent, secure, and scalable REST APIs by providing proven patterns for FastAPI and TanStack Start.

Core Features & Use Cases

  • Multi-Tenant Security: Automatically enforce tenant isolation to prevent data leaks.
  • Automated Documentation: Generate comprehensive OpenAPI docs with proper authentication.
  • Use Case: When building a new SaaS feature, use this Skill to generate complete CRUD endpoints with pagination, validation, and error handling - saving hours of manual coding and review.

Quick Start

Design a complete user management API with CRUD endpoints, pagination, and JWT authentication for a multi-tenant application.

Frequently Asked Questions about grey-haven-api-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design REST APIs with multi-tenant isolation in FastAPI?

REST API design with multi-tenant isolation in FastAPI uses repository patterns and canonical URL structures to enforce tenant separation. This Skill provides endpoint templates, Pydantic schemas, and authentication patterns that automatically prevent cross-tenant data access while maintaining consistent API structure across your application.

What's the best way to structure FastAPI endpoints with pagination and filtering?

Pagination and filtering in FastAPI REST APIs follow standardized patterns for query parameters, offset/limit handling, and response formatting. This Skill includes templates and checklists for implementing these features consistently across CRUD endpoints while maintaining schema validation and error handling.

Can I use this for TanStack Start server functions?

Yes, this Skill covers REST API design for both FastAPI backends and TanStack Start server functions. It provides patterns for endpoint creation, Pydantic validation, error handling, and OpenAPI customization that work across both frameworks.

How do I generate OpenAPI documentation with proper authentication for my API?

OpenAPI documentation generation with authentication uses customizable templates and metadata patterns. This Skill automates doc generation for your endpoints, embedding JWT authentication requirements and multi-tenant safeguards directly into your API specification.

What security patterns should I implement for rate limiting and CORS in a multi-tenant API?

Rate limiting and CORS configuration in multi-tenant APIs require enterprise-grade patterns to prevent abuse and enforce cross-origin policies. This Skill provides checklists and examples for implementing these safeguards alongside tenant isolation and authentication.

Do I need to write custom error handling for REST API endpoints?

Error handling for REST APIs follows standardized patterns to ensure consistent responses across endpoints. This Skill includes error handling templates and examples that integrate with your authentication, validation, and tenant isolation logic.