> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcollate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Breaking Changes: 1.13 to 2.0 | Official Documentation

> Component-by-component breakdown of the API, schema, ingestion, configuration, and UI breaking changes between Collate 1.13 and 2.0.

# Breaking Changes: 1.13 → 2.0

Collate 2.0 retires the thread-backed collaboration model, replaces the Explore experience, deletes
the legacy agent apps in favor of AI Automations, consolidates LLM and embedding configuration into
one block, and reshapes several API contracts.

This section lists every change that can break an existing client, script, deployment, or user
workflow, grouped by component so you only have to read the parts that apply to you.

<Warning>
  Take a full database backup before upgrading. The 2.0.0 migration renames `thread_entity`, adds more
  than 15 new tables, deletes the three legacy agent applications, and rewrites application,
  service-connection and tag rows in place. There is no automated downgrade.
</Warning>

## How to read this section

Every entry in this section is classified so you can triage quickly.

| Class           | Meaning                                                                                            |
| --------------- | -------------------------------------------------------------------------------------------------- |
| **Breaking**    | Existing callers or configurations fail outright. Action is required before or during the upgrade. |
| **Behavioural** | Requests still succeed, but the result, ordering, or side effect differs.                          |
| **Deprecated**  | Still works in 2.0, scheduled for removal. Migrate at your convenience.                            |
| **Additive**    | New surface only, listed where it replaces something you may already be using.                     |

## Changes most likely to affect you

This table summarizes the highest-impact changes across every component.

| #  | Change                                                                                                             | Component                                                                              | Class       |
| -- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ----------- |
| 1  | Documentation, Tier, and Quality agent apps are **deleted** and replaced by disabled AI Automations                | [AI Agents & Automations](/release-2.0/breaking-changes/ai-agents-and-automations)     | Breaking    |
| 2  | `/v1/suggestions/*` removed; suggestions are now Tasks                                                             | [Collaboration](/release-2.0/breaking-changes/collaboration)                           | Breaking    |
| 3  | Announcements removed from `/v1/feed`, now `/v1/announcements`                                                     | [Collaboration](/release-2.0/breaking-changes/collaboration)                           | Breaking    |
| 4  | `ingestionPipeline.pipelineStatuses` changes from an object to an **array**                                        | [Ingestion & Connectors](/release-2.0/breaking-changes/ingestion-and-connectors)       | Breaking    |
| 5  | LLM and embedding provider config moves out of `naturalLanguageSearch` into a top-level `llmConfiguration` block   | [Platform & Security](/release-2.0/breaking-changes/platform-and-security)             | Breaking    |
| 6  | Explore URL params `page`/`size` become `currentPage`/`pageSize`, plus a new `browsePath`                          | [Discovery & Search](/release-2.0/breaking-changes/discovery-and-search)               | Breaking    |
| 7  | `/v1/agents/abilities` renamed to `/v1/agents/skills`; Knowledge Center moves into Context Center                  | [AI Agents & Automations](/release-2.0/breaking-changes/ai-agents-and-automations)     | Breaking    |
| 8  | **AskCollate is renamed to Collate AI** across UI, backend, billing labels and Slack/Teams                         | [Collate AI & Credits](/release-2.0/breaking-changes/collate-ai-and-credits)           | Breaking    |
| 9  | Databricks Pipeline connections require `authType` instead of a bare `token`                                       | [Ingestion & Connectors](/release-2.0/breaking-changes/ingestion-and-connectors)       | Breaking    |
| 10 | Entity names reject `>`, `"` and ASCII control characters                                                          | [API & Schema](/release-2.0/breaking-changes/api-and-schema)                           | Breaking    |
| 11 | Search Indexing drops `recreateIndex`/`useDistributedIndexing`; reindex always recreates the index                 | [Applications & Automation](/release-2.0/breaking-changes/applications-and-automation) | Breaking    |
| 12 | `maxActiveSessionsPerUser` defaults to 5 and sessions are database-backed                                          | [Platform & Security](/release-2.0/breaking-changes/platform-and-security)             | Behavioural |
| 13 | AI Dashboards enforce visibility; every existing dashboard is set to Public on upgrade                             | [AI Agents & Automations](/release-2.0/breaking-changes/ai-agents-and-automations)     | Breaking    |
| 14 | Ingestion images move from Python 3.10 to **3.12**, and Great Expectations 1.3+ is now required                    | [Ingestion & Connectors](/release-2.0/breaking-changes/ingestion-and-connectors)       | Breaking    |
| 15 | Hybrid Runner and AI Platform images are **distroless**; no shell access                                           | [Platform & Security](/release-2.0/breaking-changes/platform-and-security)             | Breaking    |
| 16 | Custom policies aren't backfilled with the new task operations; non-admins can get `403` creating or editing tasks | [Data Governance](/release-2.0/breaking-changes/data-governance)                       | Behavioural |
| 17 | Data Insights no longer computes data quality; a stored config with `dataQuality` fails to deserialize             | [Data Quality](/release-2.0/breaking-changes/data-quality)                             | Breaking    |
| 18 | The AntV-G6 Knowledge Graph renderer is removed, replaced by an RDF-backed 3D Knowledge Graph                      | [Lineage](/release-2.0/breaking-changes/lineage)                                       | Breaking    |
| 19 | `MUI*` wrapper components are removed; the UI standardizes on `@openmetadata/ui-core-components`                   | [UI & Customization](/release-2.0/breaking-changes/ui-and-customization)               | Breaking    |

## Deprecation notices

These are not 2.0 breaking changes, but they change what you should build on now.

<Warning>
  **Airflow as the internal orchestrator is deprecated and will be removed in a future release.** The
  native Kubernetes Orchestrator, released in 1.12, is its replacement. Existing Airflow-based
  deployments keep working in 2.0 but should plan a migration.
</Warning>

<Warning>
  **Great Expectations 0.x is no longer supported.** 2.0 requires Great Expectations 1.3 or later. See
  [Ingestion & Connectors](/release-2.0/breaking-changes/ingestion-and-connectors).
</Warning>

## Browse by component

<Columns cols={2} className="product-cards">
  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/ai-automation.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=7d4fa2cf97f6984f6cb7133b773e1e9c" title="AI Agents & Automations" href="/release-2.0/breaking-changes/ai-agents-and-automations" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/ai-automation.png">
    Agent apps replaced by AI Automations, the abilities-to-skills rename, Knowledge Center moving into Context Center, and AI Dashboard/chart changes.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/billing-usage.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=646cf6a8cc7ab59ea73196596db91b91" title="Collate AI & Credits" href="/release-2.0/breaking-changes/collate-ai-and-credits" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/billing-usage.png">
    The AskCollate-to-Collate AI rename, the reworked weighted credit model, and Slack/Teams changes.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/data-collaboration.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=ee5864c07a792d228b0341fd7d374dcf" title="Collaboration" href="/release-2.0/breaking-changes/collaboration" horizontal width="53" height="53" data-path="public/images/ai-2.0/ai-icons/data-collaboration.png">
    Task redesign, Suggestions API removal, standalone Announcements and the Activity Stream.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/search-discovery.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=eefb96033f1a40c961cb15f6ded19f11" title="Discovery & Search" href="/release-2.0/breaking-changes/discovery-and-search" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/search-discovery.png">
    The redesigned Explore page, changed URL parameters and staged ranking.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/roles-polocies.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=a9ae119153bc4a0ca64f85930bd3cd27" title="Data Governance" href="/release-2.0/breaking-changes/data-governance" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/roles-polocies.png">
    Task-based governance workflows, glossary and ontology, classification, and the Policy Agent.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/data-quality.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=54cca326565a13719922b4da2e73c561" title="Data Quality" href="/release-2.0/breaking-changes/data-quality" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/data-quality.png">
    Incidents as Tasks, inlined incident status and the removed Data Insights DQ module.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/workflows.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=c53d5aa7a1e5779dbe1492b324dd0406" title="Lineage" href="/release-2.0/breaking-changes/lineage" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/workflows.png">
    FQN-based edge APIs, batch hydration and time-window traversal semantics.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/ingest-data.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=641f6b36a5a4fe48d664b5125ed6e4c5" title="Ingestion & Connectors" href="/release-2.0/breaking-changes/ingestion-and-connectors" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/ingest-data.png">
    pipelineStatuses, Databricks Pipeline auth, log-stream payloads, Great Expectations 1.x and Python 3.12.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/mcp-server.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=52e9f84ace82051e9261d3ee824feba1" title="API & Schema" href="/release-2.0/breaking-changes/api-and-schema" horizontal width="96" height="96" data-path="public/images/ai-2.0/ai-icons/mcp-server.png">
    Removed endpoints, changed request contracts, tightened validation and enum changes.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/application.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=bf6ad26a91493ebb47ad140fa94a774f" title="Applications & Automation" href="/release-2.0/breaking-changes/applications-and-automation" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/application.png">
    Search Indexing app config, RDF Index defaults, Data Insights module changes and MCP tool contracts.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/sso-auth.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=491e364d9e40fef4f7dcdebc8cf244e1" title="Platform & Security" href="/release-2.0/breaking-changes/platform-and-security" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/sso-auth.png">
    llmConfiguration, session limits, database timeouts and the 2.0.0 database migration.
  </Card>

  <Card icon="https://mintcdn.com/collatedocs/upR0ShcKvEojE0Rd/public/images/ai-2.0/ai-icons/collate-desktop.png?fit=max&auto=format&n=upR0ShcKvEojE0Rd&q=85&s=98717df52656df7d3e63102f5df6e074" title="UI & Customization" href="/release-2.0/breaking-changes/ui-and-customization" horizontal width="48" height="48" data-path="public/images/ai-2.0/ai-icons/collate-desktop.png">
    Design-system consolidation, App Mode and removed UI components.
  </Card>
</Columns>

## Upgrade checklist

<Steps>
  <Step title="Inventory your API clients">
    Search scripts, dashboards, Terraform, and CI jobs for `/v1/suggestions`, `/v1/feed`,
    `/v1/agents/abilities`, `search_after=`, `pipelineStatuses` and `recreateIndex`.
  </Step>

  <Step title="Port your LLM configuration">
    The `elasticsearch.naturalLanguageSearch.*` provider blocks no longer exist. Move them to
    `llmConfiguration` before you upgrade, set `LLM_ENABLED`/`LLM_PROVIDER`, and review
    `hybridSearch.semanticScoreThreshold` (default changes to `0.7`) — otherwise semantic search
    silently degrades to a no-op provider.
  </Step>

  <Step title="Update Databricks Pipeline YAML">
    Change `token: dapi...` to `authType: { token: dapi... }` in any external ingestion YAML. Stored
    service configurations migrate automatically; YAML files do not.
  </Step>

  <Step title="Record your agent app configuration and reissue bot tokens">
    The Documentation, Tier, and Quality agent apps are deleted during the upgrade — note their
    filters and schedules. Reissue any token built against `CollateAIApplicationBot`,
    `CollateAIQualityAgentApplicationBot` or `CollateAITierAgentApplicationBot` against
    `AIAutomationApplicationBot` before upgrading.
  </Step>

  <Step title="Check entity names for newly invalid characters">
    `>`, `"` and ASCII control characters are rejected by name validation in 2.0.
  </Step>

  <Step title="Back up the database and run the upgrade">
    Expect data migrations for suggestions and thread tasks into the Task entity, system feed threads
    into the Activity Stream, and announcements into their own entity.
  </Step>

  <Step title="Allow a full search reindex">
    Reindexing in 2.0 always recreates the index. There is no incremental mode.
  </Step>

  <Step title="Re-enable your migrated automations and Slack receivers">
    Open AI Automations, find the entries suffixed **(migrated)**, review the carried-over filter,
    then enable and schedule each one. Legacy webhook-URL Slack receivers are not migrated —
    re-enter them in the AI Automations UI.
  </Step>

  <Step title="Review AI Dashboard and chart visibility">
    Every dashboard is set to Public on upgrade to preserve access; restrict the ones that shouldn't
    be org-wide. Review any AI chart split across multiple dashboards.
  </Step>

  <Step title="Add cardinality distribution to the profiler if you need it">
    It's no longer part of the default profiler agent configuration — add it back explicitly if the
    Analytics Agent or other tooling relies on distinct-value data.
  </Step>

  <Step title="Audit alerts with an entity name filter">
    Filter matching is now literal, not regular-expression, and thread events are scoped to the
    entity they're about. Widen or remove filters if an alert goes quiet after upgrading.
  </Step>

  <Step title="Allow-list the Chrome plugin's callback URI">
    Add the full callback URI (`https://<extension-id>.chromiumapp.org/auth0`) to
    `additionalTrustedRedirectUris`, or the plugin won't complete login.
  </Step>

  <Step title="Rebuild custom ingestion images and connectors">
    Ingestion moves to Python 3.12. `cp310` wheels will not load. Migrate the `great-expectations`
    plugin from 0.x to `~=1.3` if you use it.
  </Step>

  <Step title="Remove shell-access steps for Hybrid Runner and AI Platform pods">
    Both images are now distroless. Move any operational playbook that used `kubectl exec` to logs,
    metrics or `kubectl debug`.
  </Step>
</Steps>

## Version scope

The 2.0.0 upgrade covers the following version and specification range.

|                           |                                              |
| ------------------------- | -------------------------------------------- |
| **From**                  | Collate 1.13 line (1.13.0–1.13.4)            |
| **To**                    | Collate 2.0.0                                |
| **Platform REST surface** | 208 endpoints added, 10 removed              |
| **Collate REST surface**  | 76 endpoints added, 47 removed               |
| **Schema spec**           | 86 new schema files, 107 modified, 3 removed |

<Note>
  Where this guide names a file, environment variable, package, or HTTP header, it uses the literal
  identifier as it appears in the product, for example `openmetadata.yaml`, `openmetadata-ingestion` or
  `/api/v1/`. Those names are unchanged in 2.0.
</Note>