fastapi

name	fastapi
description	Guidance for building FastAPI routes, Pydantic v2 schemas, async endpoints, dependency injection, and middleware.

FastAPI Skill Directive

1. **APIRouter Organization**: Group endpoints logically in `backend/app/api/v1/endpoints/`. Use explicit tags, summary descriptions, and response models. 2. **Pydantic v2 Schemas**: Define separate `Create`, `Update`, and `Response` schemas in `backend/app/schemas/`. Use strict field validation and `ConfigDict(from_attributes=True)`. 3. **Dependency Injection**: Inject database sessions, current users, and shared services using `FastAPI.Depends()`. 4. **Async Best Practices**: Declare endpoints with `async def` for I/O operations. Use async SQLAlchemy sessions (`AsyncSession`). 5. **Exception Handling**: Raise `HTTPException(status_code=..., detail=...)` with standard HTTP error status codes.