Skip to main content
You start every workflow by defining the structure of the incoming event. A Pydantic schema becomes the single source of truth for validation, documentation, and serialization.

​
Why Schemas Matter

Schemas give you automatic type validation, inline documentation through field descriptions, and straightforward JSON serialization, so you can accept reliable inputs and publish clear API docs without extra boilerplate.

​
Customer Care Event Schema

For our customer care use case, we’ve defined the following schema: 
from datetime import datetime, timezone
from pydantic import BaseModel, Field
from uuid import UUID, uuid4


class CustomerCareEventSchema(BaseModel):
    ticket_id: UUID = Field(
        default_factory=uuid4, 
        description="Unique identifier for the ticket"
    )
    timestamp: datetime = Field(
        default_factory=lambda: datetime.now(timezone.utc),
        description="Time when the ticket was created",
    )
    from_email: str = Field(
        ..., 
        description="Email address of the sender"
    )
    to_email: str = Field(
        ..., 
        description="Email address of the recipient"
    )
    sender: str = Field(
        ..., 
        description="Name or identifier of the sender"
    )
    subject: str = Field(
        ..., 
        description="Subject of the ticket"
    )
    body: str = Field(
        ..., 
        description="The body of the ticket"
    )

​
Schema Components Explained

​
Automatic ID Generation

The ticket_id field uses default_factory=uuid4 to automatically generate a unique identifier for each ticket when created.

​
Timestamp Management

The timestamp field automatically captures the creation time in UTC, ensuring consistent time tracking across different timezones.

​
Required Fields

Fields marked with ... (ellipsis) are required and must be provided when creating an event instance.

​
Field Descriptions

Each field includes a description that serves as inline documentation and helps with API documentation generation.

​
File Location

Place schemas in app/schemas to keep data models discoverable and consistent across projects.