# What changed in azure-search-documents

> 22 changes in azure-search-documents 12 from its official release notes, upgrade guides and advisories: 5 breaking, 1 deprecations, 13 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/pypi/azure-search-documents/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## azure-search-documents 12

### Breaking changes

- Model deserialize() methods are removed; use the model constructor to deserialize. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Replaces PathHierarchyTokenizer under its renamed model name. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- The MYSQL enum value replaces MY_SQL. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- The ONELAKE enum value replaces ONE_LAKE. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Model serialize() methods are removed; use as_dict() to serialize. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)

### Deprecations

- retrievable is now the native property instead of hidden; hidden remains as a backward-compatible inverse getter/setter. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)

### New APIs and options

- Adds a model for Azure Blob knowledge sources. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds native Markdown file parsing for blob indexers. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a model for chat completion skills. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a model for content understanding skills. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a model for indexed OneLake knowledge sources. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a setting for Markdown sectioning header depth, from h1 through h6. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a setting to control Markdown document splitting with oneToOne or oneToMany. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds the KnowledgeBase model for knowledge base support. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a client for knowledge base retrieval. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds managed identity support for data source connections. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds managed identity support for knowledge store projections. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a model for search index knowledge sources. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Adds a model for web knowledge sources. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)

### Behavior and default changes

- The default API version is updated to 2026-04-01. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)
- Enum values are now UPPER_CASE; PascalCase aliases remain available at runtime. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)

### Fixes and other changes

- The key_version property is now optional, aligning with service behavior. (12.0.0) — [release notes](https://github.com/Azure/azure-sdk-for-python/releases/tag/azure-search-documents_12.0.0)