FastAPI changelog

Automatic OpenTelemetry exporter setup is now opt-in. If you rely on FastAPI to configure exporters from OTEL_* environment variables, set FASTAPI_OTEL_AUTO_CONFIGURE=true or use FastAPI(telemetry={"auto_configure": True}) to retain the pre

Fixes 🐛 Isolate FastAPI telemetry for excluded requests. PR #16470 by @tiangolo.

Fixes 🐛 Cache OpenTelemetry tracers to preserve warning deduplication. PR #16468 by @tiangolo. Docs 📝 Remove HTML title from newsletter to avoid the tooltip. PR #16461 by @tiangolo. 📝 Embed the FastAPI and friends newsletter signup form.

Fixes 🐛 Allow startup when automatic OpenTelemetry configuration fails. PR #16418 by @tiangolo.

Fixes 🐛 Fix repeated endpoint wrapping in included routers. PR #16414 by @tiangolo.

Features ✨ Add native OpenTelemetry support. PR #16403 by @tiangolo. Refactors 📱 Improve mobile responsiveness of conference rail. PR #16196 by @alejsdev. ♻️ Remove conf section and add event banner. PR #16193 by @alejsdev. Docs 🔥 Remove

Fixes 🐛 Fix support for background tasks and headers from dependencies in app.frontend(). PR #16105 by @tiangolo. Docs 📝 Document FASTAPI_ENV in FastAPI CLI guide. PR #16104 by @tiangolo.

Features ✨ Add app.frontend(check_dir="auto"), to make local development more convenient with fastapi dev. PR #16102 by @tiangolo.

Fixes 🐛 Fix status_code being ignored for SSE and JSONL streaming endpoints. PR #15937 by @SAURABHSALVE. Docs 📝 Fix format_sse_event docstring rendering of \n\n terminator. PR #15613 by @AshNicolus. 📝 Add API reference page for fastapi.s

Fixes 🐛 Fix line splitting in format_sse_event to comply with SSE spec. PR #15515 by @Zawwarsami16.

Fixes 🐛 Fix response_model_* params ignored for non-generator endpoints with Iterable[..] return type. PR #15093 by @YuriiMotov.

Fixes 🐛 Fix handling sequences with nested Annotated types. PR #14874 by @YuriiMotov. Internal 🐛 Accept any base test failure as regression. PR #16092 by @tiangolo. 🐛 Preserve pytest exit code in regression check. PR #16091 by @tiangolo.

Fixes 🐛 Fix exclude_defaults not propagated to dict keys and values in jsonable_encoder. PR #16043 by @MBGrao. Internal ⬆ Bump gitpython from 3.1.50 to 3.1.54. PR #16047 by @dependabot[bot]. ⬆ Bump pymdown-extensions from 10.21.3 to 11.0.

Fixes 🐛 Fix stream item type lost when using include_router(). PR #15077 by @alex-raw.

Refactors ⚡️ Avoid flattening dependencies for OpenAPI. PR #16076 by @tiangolo. Internal ⬆️ Upgrade latest-changes to 0.7.1. PR #16077 by @tiangolo. 👷 Add OpenAPI dependency benchmarks. PR #16075 by @tiangolo.

Refactors ⚡️ Avoid flattening dependencies for request parameters, mainly for OpenAPI. PR #16073 by @tiangolo.

Refactors ⚡️ Avoid flattening dependencies for body fields. PR #16071 by @tiangolo.

Refactors ⚡️ Skip unused dependency repeat bookkeeping. PR #16069 by @tiangolo.

Refactors ⚡️ Avoid repeated dependency flattening in OpenAPI. PR #16067 by @tiangolo.

Refactors ⚡️ Stop retaining flat dependency trees. PR #16065 by @tiangolo. Internal 👷 Add new memory benchmark. PR #16064 by @tiangolo.

Refactors ♻️ Update the lru_cache limit for dependencies to account for large apps. PR #16062 by @tiangolo.

Refactors ⚡️ Reduce memory usage in dependencies. PR #16049 by @tiangolo. Docs 📝 Fix links in docs. PR #15967 by @YuriiMotov. 📝 Add Library Skills documentation. PR #16041 by @tiangolo. 📝 Update docs to use uv projects by default. PR #16

Fixes 🐛 Refactor router route building to make it thread-safe, mainly relevant for tests running in parallel threads (uncommon). PR #16013 by @tiangolo.

Fixes 🐛 Fix frontend fallback support for doted paths like /users/john.doe. PR #16011 by @tiangolo. Docs 📝 Fix topic repository list not being displayed and skip_users not being applied. PR #15995 by @YuriiMotov. Translations 🌐 Update tr

Features ✨ Support dependencies in app.frontend(), e.g. for automatic cookie authentication for the frontend. PR #15908 by @tiangolo. Translations 🌐 Update translations for fr (update-outdated). PR #15897 by @tiangolo. 🌐 Update translatio

Refactors ♻️ Make app.frontend() return 404 for methods other than GET or HEAD with no static file matches. PR #15863 by @tiangolo. Internal 🔧 Update sponsors: remove Stainless. PR #15862 by @tiangolo. ♻️ Refactor how sponsors data is hand

Refactors ♻️ Refactor Library Skills, make info easier to find for agents. PR #15841 by @tiangolo. Internal 👷 Simplify pull request workflow triggers. PR #15836 by @tiangolo. 👷 Update issue-manager to 0.7.1. PR #15833 by @tiangolo. ⬆️ Upd

Features ✨ Add support for app.frontend("/", directory="dist") and router.frontend("/", directory="dist"). PR #15800 by @tiangolo. Read the docs: Frontend. Docs 📝 Fix typo in release notes. PR #15807 by @tiangolo. 📝 Add app.frontend() ins

Features ✨ Add iter_route_contexts() for advanced use cases that used to use router.routes (e.g. Jupyverse). PR #15785 by @tiangolo. Translations 🌐 Fix broken Markdown in Korean custom response docs. PR #15774 by @kooqooo. 🌐 Update transl

Fixes 🚨 Fix typing checks for APIRoute. PR #15765 by @tiangolo. 🐛 Fix bug, allow empty path in path operation in prefixless router. PR #15763 by @tiangolo.

Breaking Changes ♻️ Refactor internals to preserve APIRouter and APIRoute instances. PR #15745 by @tiangolo. Unblocks ✨ SO MANY THINGS ✨ Before this, router.include_router(other_router) would take each path operation from other_router and "

Refactors ♻️ Do not accept underscore headers when using convert_underscores=True (the default). PR #15589 by @tiangolo.

Refactors ♻️ Validate Server Sent Event fields to avoid applications from sending broken data. PR #15588 by @tiangolo. Docs 📝 Document --entrypoint CLI option. PR #15464 by @YuriiMotov. 📝 Update and simplify docs about help and management

Upgrades ⬆️ Update Pydantic v2 code to address deprecations. PR #15101 by @svlandeg. Internal 🔨 Tweak translation script. PR #15174 by @YuriiMotov. ⬆ Bump mkdocs-material from 9.7.1 to 9.7.6. PR #15408 by @dependabot[bot]. ⬆ Bump inline-sn

Upgrades ⬆️ Support free-threaded Python 3.14t. PR #15149 by @svlandeg.

Refactors 🔥 Remove April Fool's @app.vibe() 🤪. PR #15363 by @tiangolo. Internal ⬆ Bump cryptography from 46.0.5 to 46.0.7. PR #15314 by @dependabot[bot]. ⬆ Bump strawberry-graphql from 0.307.1 to 0.312.3. PR #15309 by @dependabot[bot]. 🔨

Features ✨ Add support for @app.vibe(). PR #15280 by @tiangolo. New docs: Vibe Coding. Docs ✏️ Fix typo for client_secret in OAuth2 form docstrings. PR #14946 by @bysiber. Internal 👥 Update FastAPI People - Experts. PR #15279 by @tiangolo.

Upgrades ⬆️ Increase lower bound to pydantic >=2.9.0. and fix the test suite. PR #15139 by @svlandeg. Docs 📝 Add missing last release notes dates. PR #15202 by @tiangolo. 📝 Update docs for contributors and team members regarding translati

Fixes 🐛 Fix, avoid yield from a TaskGroup, only as an async context manager, closed in the request async exit stack. PR #15038 by @tiangolo. Docs ✏️ Fix typo in docs/en/docs/_llm-test.md. PR #15007 by @adityagiri3600. 📝 Update Skill, opti

Features ✨ Add support for Server Sent Events. PR #15030 by @tiangolo. New docs: Server-Sent Events (SSE).

Features ✨ Add support for streaming JSON Lines and binary data with yield. PR #15022 by @tiangolo. This also upgrades Starlette from >=0.40.0 to >=0.46.0, as it's needed to properly unrwap and re-raise exceptions from exception groups. New

Features 🔧 Add FastAPI Agent Skill. PR #14982 by @tiangolo. Read more about it in Library Agent Skills. Internal ✅ Fix all tests are skipped on Windows. PR #14994 by @YuriiMotov.

Upgrades ⬆️ Add support for Starlette 1.0.0+. PR #14987 by @tiangolo.

Refactors ♻️ Refactor logic to handle OpenAPI and Swagger UI escaping data. PR #14986 by @tiangolo. Internal 👥 Update FastAPI People - Experts. PR #14972 by @tiangolo. 👷 Allow skipping benchmark job in test workflow. PR #14974 by @YuriiMo

Breaking Changes 🔒️ Add strict_content_type checking for JSON requests. PR #14978 by @tiangolo. Now FastAPI checks, by default, that JSON requests have a Content-Type header with a valid JSON value, like application/json, and rejects reque

Breaking Changes 🗑️ Deprecate ORJSONResponse and UJSONResponse. PR #14964 by @tiangolo.

Features ✨ Serialize JSON response with Pydantic (in Rust), when there's a Pydantic return type or response model. PR #14962 by @tiangolo. This results in 2x (or more) performance increase for JSON responses. New docs: Custom Response - JSO

Internal ⬆️ Upgrade pytest. PR #14959 by @tiangolo. 👷 Fix CI, do not attempt to publish fastapi-slim. PR #14958 by @tiangolo. ➖ Drop support for fastapi-slim, no more versions will be released, use only "fastapi[standard]" or fastapi. PR #

Fixes ♻️ Fix JSON Schema for bytes, use "contentMediaType": "application/octet-stream" instead of "format": "binary". PR #14953 by @tiangolo. Docs 🔨 Add Kapa.ai widget (AI chatbot). PR #14938 by @tiangolo. 🔥 Remove Python 3.9 specific fil

Breaking Changes ➖ Drop support for Python 3.9. PR #14897 by @tiangolo. Refactors 🎨 Update internal types for Python 3.10. PR #14898 by @tiangolo. Docs 📝 Update highlights in webhooks docs. PR #14905 by @tiangolo. 📝 Update source example

Docs 📝 Fix grammar in docs/en/docs/tutorial/first-steps.md. PR #14708 by @SanjanaS10. Internal 🔨 Tweak PDM hook script. PR #14895 by @tiangolo. ♻️ Update build setup for fastapi-slim, deprecate it, and make it only depend on fastapi. PR #

Features ✨ Show a clear error on attempt to include router into itself. PR #14258 by @JavierSanchezCastro. ✨ Replace dict by Mapping on HTTPException.headers. PR #12997 by @rijenkii. Refactors ♻️ Simplify reading files in memory, do it sequ

Fixes 🐛 Fix on_startup and on_shutdown parameters of APIRouter. PR #14873 by @YuriiMotov. Translations 🌐 Update translations for zh (update-outdated). PR #14843 by @tiangolo. Internal ✅ Fix parameterized tests with snapshots. PR #14875 by

Refactors ♻️ Refactor and simplify Pydantic v2 (and v1) compatibility internal utils. PR #14862 by @tiangolo. Internal ✅ Add inline snapshot tests for OpenAPI before changes from Pydantic v2. PR #14864 by @tiangolo.

Refactors ♻️ Refactor internals, simplify Pydantic v2/v1 utils, create_model_field, better types for lenient_issubclass. PR #14860 by @tiangolo. ♻️ Simplify internals, remove Pydantic v1 only logic, no longer needed. PR #14857 by @tiangolo.

Refactors ♻️ Re-implement on_event in FastAPI for compatibility with the next Starlette, while keeping backwards compatibility. PR #14851 by @tiangolo. Upgrades ⬆️ Upgrade Starlette supported version range to starlette>=0.40.0,<1.0.0. PR #1

Features ✨ Add support for PEP695 TypeAliasType. PR #13920 by @cstruct. ✨ Allow Response type hint as dependency annotation. PR #14794 by @jonathan-fulton. Fixes 🐛 Fix using Json[list[str]] type (issue #10997). PR #14616 by @mkanetsuna. Do

Features ✨ Add viewport meta tag to improve Swagger UI on mobile devices. PR #14777 by @Joab0. 🚸 Improve error message for invalid query parameter type annotations. PR #14479 by @retwish. Fixes 🐛 Update ValidationError schema to include i

Breaking Changes ➖ Drop support for pydantic.v1. PR #14609 by @tiangolo. Internal ✅ Run performance tests only on Pydantic v2. PR #14608 by @tiangolo.

Refactors 🔊 Add a custom FastAPIDeprecationWarning. PR #14605 by @tiangolo. Docs 📝 Add documentary to website. PR #14600 by @tiangolo. Translations 🌐 Update translations for de (update-outdated). PR #14602 by @nilslindemann. 🌐 Update tr

Breaking Changes 🔊 Add deprecation warnings when using pydantic.v1. PR #14583 by @tiangolo. Translations 🔧 Add LLM prompt file for Korean, generated from the existing translations. PR #14546 by @tiangolo. 🔧 Add LLM prompt file for Japane

Upgrades ➖ Drop support for Pydantic v1, keeping short temporary support for Pydantic v2's pydantic.v1. PR #14575 by @tiangolo. The minimum version of Pydantic installed is now pydantic >=2.7.0. The standard dependencies now include pydanti

Breaking Changes 🔧 Drop support for Python 3.8. PR #14563 by @tiangolo. This would actually not be a breaking change as no code would really break. Any Python 3.8 installer would just refuse to install the latest version of FastAPI and wou

Fixes 🐛 Fix parameter aliases. PR #14371 by @YuriiMotov.

Fixes 🐛 Fix support for tagged union with discriminator inside of Annotated with Body(). PR #14512 by @tiangolo. Refactors ✅ Add set of tests for request parameters and alias. PR #14358 by @YuriiMotov. Docs 📝 Tweak links format. PR #14505

Fixes 🐛 Fix support for if TYPE_CHECKING, non-evaluated stringified annotations. PR #14485 by @tiangolo.