Microsoft skill library
Original source, preserved
Field guide 01
Information
Python · Pydantic v2 · API contracts

One resource.
Five precise
model shapes.

Give creation, updates, responses and stored documents their own clear data contract.

Pydantic Models
5

Related models.
Deliberately different responsibilities.

01Base

Shared fields and their constraints.

02Create

Required input for a new resource.

03Update

Optional fields for partial changes.

04Response

Public identifiers and timestamps.

05InDB

A response plus its document type.

8-second concept film. Illustrative motion, separate from the execution evidence below.

Better boundaries.
Less ambiguity.

A Microsoft-authored skill for Python developers shaping request schemas, response models and database document structures. It provides a reusable template and guidance, rather than a running API.

The original instructions cover camelCase aliases, optional update fields, JSON-safe serialization and schema generation. Adapt the fields to your application's rules.

A resource definition.

The resource name, fields, required values, length limits, identifiers and timestamp conventions.

A Python model family.

Base, Create, Update, response and InDB classes, with a schema and serialization behavior that can be inspected.

Use it for

  • Python API request and response contracts.
  • Partial-update payloads that preserve omitted fields.
  • Structured resource models with explicit validation.

Outside its scope

  • Running an API or connecting a database.
  • Inventing your business rules or authorization policy.
  • Automatically migrating existing database records.
7/7

Local test groups passed.
The original template, with documented Project substitutions, was tested for validation, aliases, partial updates, serialization, document shape and schema. This is not an end-to-end agent evaluation.