Summary
This release enhances our Event Handler with support for Pydantic Models when validating query strings and headers parameters. This addition brings type safety, automatic validation, and better developer experience to your API endpoints.
A super thanks to @tonnico for implementing this important feature π π
π Announcement: You can now find our documentation on the official AWS documentation domain at docs.aws.amazon.com/powertools/python.
Using Pydantic models to validate query strings and headers parameters
You can now use Pydantic's models to validate query strings and headers parameters. This allows you to have structured, type-safe validation with automatic error handling and clear validation messages.
Why this important:
- Type safety: Catch validation errors at runtime with clear error messages
- Developer experience: Get IDE autocompletion and type hints for your parameters
- Documentation: Self-documenting code through Pydantic model definitions
- Model reusability: Use the same validation model across multiple endpoints for consistency

Changes
πNew features and non-breaking changes
π Documentation updates
- docs(idempotency): removed inexistent css class (#7539) by @leandrodamascena
π Bug and hot fixes
- fix(event_handler): Preserve
examples
field in OpenAPI schema for BedrockAgentResolver (#7561) by @leandrodamascena
π§ Maintenance
- chore(deps-dev): bump sentry-sdk from 2.42.0 to 2.42.1 (#7562) by @dependabot[bot]
- chore(deps-dev): bump nox from 2025.10.14 to 2025.10.16 (#7557) by @dependabot[bot]
- chore(deps-dev): bump mypy-boto3-appconfigdata from 1.40.0 to 1.40.55 in the boto-typing group (#7554) by @dependabot[bot]
- chore(deps-dev): bump boto3-stubs from 1.40.54 to 1.40.55 (#7555) by @dependabot[bot]
- chore(deps): bump pydantic from 2.12.2 to 2.12.3 (#7556) by @dependabot[bot]
- chore(deps-dev): bump boto3-stubs from 1.40.53 to 1.40.54 (#7547) by @dependabot[bot]
- chore(deps): bump protobuf from 6.32.1 to 6.33.0 (#7544) by @dependabot[bot]
- chore(deps): bump avro from 1.12.0 to 1.12.1 (#7546) by @dependabot[bot]
- chore(deps-dev): bump ruff from 0.14.0 to 0.14.1 (#7545) by @dependabot[bot]
- chore(ci): update CONTRIBUTING.md (#7549) by @ConnorKirk
- chore(deps-dev): bump sentry-sdk from 2.41.0 to 2.42.0 (#7533) by @dependabot[bot]
- chore(deps-dev): bump boto3-stubs from 1.40.51 to 1.40.53 (#7535) by @dependabot[bot]
- chore: use approved sample names and addresses (#7542) by @sthulb
- chore(deps-dev): bump nox from 2024.10.9 to 2025.10.14 (#7532) by @dependabot[bot]
- chore(deps): bump mkdocs-material from 9.6.21 to 9.6.22 (#7534) by @dependabot[bot]
- chore(deps): bump mkdocs-material from 9.6.21 to 9.6.22 in /docs (#7531) by @dependabot[bot]
- chore(deps): bump squidfunk/mkdocs-material from
00f9276
tof5c556a
in /docs (#7530) by @dependabot[bot] - chore(deps): bump pydantic from 2.12.0 to 2.12.2 (#7522) by @dependabot[bot]
- chore(deps-dev): bump cfn-lint from 1.40.1 to 1.40.2 (#7525) by @dependabot[bot]
- chore(deps-dev): bump cdklabs-generative-ai-cdk-constructs from 0.1.310 to 0.1.311 (#7523) by @dependabot[bot]
- chore(deps-dev): bump aws-cdk-aws-lambda-python-alpha from 2.219.0a0 to 2.220.0a0 (#7526) by @dependabot[bot]
- chore(deps-dev): bump aws-cdk-lib from 2.219.0 to 2.220.0 (#7524) by @dependabot[bot]
- chore(deps): bump actions/setup-node from 5.0.0 to 6.0.0 (#7521) by @dependabot[bot]
- chore(deps-dev): bump boto3-stubs from 1.40.49 to 1.40.51 (#7517) by @dependabot[bot]
- chore(deps): bump actions/dependency-review-action from 4.8.0 to 4.8.1 (#7516) by @dependabot[bot]
- chore(deps-dev): bump ijson from 3.4.0 to 3.4.0.post0 (#7510) by @dependabot[bot]
- chore(deps-dev): bump aws-cdk from 2.1029.4 to 2.1030.0 (#7508) by @dependabot[bot]
- chore(deps-dev): bump cdklabs-generative-ai-cdk-constructs from 0.1.309 to 0.1.310 (#7509) by @dependabot[bot]
- chore(ci): improve message when do-not-merge label is present (#7505) by @tonnico
- chore(deps-dev): bump cfn-lint from 1.40.0 to 1.40.1 (#7502) by @dependabot[bot]
- chore(deps-dev): bump boto3-stubs from 1.40.47 to 1.40.49 (#7503) by @dependabot[bot]
- chore(deps-dev): bump sentry-sdk from 2.40.0 to 2.41.0 (#7504) by @dependabot[bot]
- chore(deps): bump valkey-glide from 2.1.0 to 2.1.1 (#7498) by @dependabot[bot]
- chore(deps-dev): bump types-python-dateutil from 2.9.0.20250822 to 2.9.0.20251008 (#7499) by @dependabot[bot]
This release was made possible by the following contributors:
@ConnorKirk, @dependabot[bot], @github-actions[bot], @leandrodamascena, @sthulb, @tonnico, dependabot[bot] and github-actions[bot]