pydantic-model

Design Pydantic v2 models for API validation and MongoDB integration.

27|9|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill pydantic-model-georgekhananaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pydantic-model
Source: https://github.com/georgekhananaev/claude-skills-vault/tree/main/.claude/skills/pydantic-model
Command: npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill pydantic-model-georgekhananaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pydantic v2 offers structured, typed data models for validating requests and responses, simplifying MongoDB conversions, and enforcing consistent data rules across services.

Core Features & Use Cases

  • Create robust API models: define Create, Update, and Get patterns with explicit field constraints and validators.
  • MongoDB integration: seamless mapping between MongoDB documents and API DTOs via from_mongo and to_mongo-like patterns.
  • Validation discipline: enforce type safety, enum constraints, and cross-field validation using @field_validator and @model_validator.

Quick Start

Define a v2-based model in app/classes/<feature>/<feature>_models.py with a Create/Update/Get trio, implement a from_mongo() method to translate docs into API-friendly data, and export the models from init.py.

Frequently Asked Questions about pydantic-model

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

FAQPage Schema
How do I create Pydantic v2 models for API request and response validation?

To create Pydantic v2 models for API validation, define a Create, Update, and Get model trio with explicit field constraints. Use @field_validator and @model_validator to enforce type safety, enum constraints, and cross-field validation across your API data layers.

What is the best way to map MongoDB documents to Pydantic v2 API models?

Mapping MongoDB documents to Pydantic v2 API models is best achieved by implementing a from_mongo() method. This pattern seamlessly translates MongoDB documents into API-friendly data transfer objects while maintaining strict type safety and validation discipline.

How do I enforce cross-field validation in Pydantic v2?

To enforce cross-field validation in Pydantic v2, use the @model_validator decorator. This allows you to define rules that check multiple fields simultaneously, ensuring data integrity and consistency across complex API request models.

Does Pydantic v2 work with MongoDB integration for API data layers?

Pydantic v2 works effectively with MongoDB integration by using seamless mapping patterns like from_mongo and to_mongo. This combination ensures reliable, reusable data layers that enforce consistent data rules across your services.

Can I use field validators and model validators together in Pydantic v2?

You can use @field_validator and @model_validator together in Pydantic v2. Field validators handle individual field constraints, while model validators manage cross-field validation, ensuring comprehensive type safety and data rules across Create, Update, and Get patterns.

What are the limitations of using Pydantic v2 for MongoDB API models?

When using Pydantic v2 for MongoDB API models, you must maintain a strict export pattern from __init__.py and structure models in specific directory paths. This requires careful organization of Create, Update, and Get trios to ensure reliable data layer reusability.