> ## 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.

# Collate 2.0: What Changed | Official Documentation

> Everything that changes when you move from Collate 1.13 to 2.0, the new AI Mode, plus a component-by-component breakdown of breaking API, ingestion, configuration and UI changes.

# Collate 2.0: What Changed

Collate 2.0 is a major release. It:

* Introduces **AI Mode**.
* Retires the thread-backed collaboration model.
* Replaces the Explore experience.
* Converts the agent apps into AI Automations.
* Moves LLM and embedding configuration into one place.
* Reshapes several API contracts.

This section covers everything that can break an existing client, script, deployment or user
workflow, broken out by component so you only read the parts that apply to you.

<Card title="Start here: AI Mode" icon="sparkles" href="/ai-2-0/release-2.0/ai-mode">
  In 2.0, the headline change is a second, AI-native interface. Every new capability lands there first.
  Learn what is in it and how to turn it on for yourself, a persona, or the whole tenant.
</Card>

<Warning>
  Take a full database backup before upgrading. The 2.0.0 migration renames tables, creates more than
  15 new ones, deletes the three agent applications, and rewrites application, service-connection
  and tag rows in place. No automated downgrade path exists.
</Warning>

## How to read this section

| 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 currently be using.                   |

Each entry states **what changed**, **who is affected** and **what to do**.

## The changes most likely to affect you

| #  | Change                                                                                                        | Component                                                                | Class       |
| -- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ----------- |
| 1  | The Documentation, Tier and Quality **agent apps are deleted** and converted into **disabled** AI Automations | [AI Agents & Automations](/ai-2-0/release-2.0/ai-agents-and-automations) | Breaking    |
| 2  | `/v1/suggestions/*` removed, suggestions are now Tasks                                                        | [Collaboration](/ai-2-0/release-2.0/collaboration)                       | Breaking    |
| 3  | Announcements removed from `/v1/feed`, now `/v1/announcements`                                                | [Collaboration](/ai-2-0/release-2.0/collaboration)                       | Breaking    |
| 4  | `ingestionPipeline.pipelineStatuses` is now an **array**                                                      | [Ingestion & Connectors](/ai-2-0/release-2.0/ingestion-and-connectors)   | Breaking    |
| 5  | Embedding and NLQ provider config moves to a top-level `llmConfiguration` block                               | [Platform & Security](/ai-2-0/release-2.0/platform-and-security)         | Breaking    |
| 6  | Explore URL params `page`/`size` → `currentPage`/`pageSize`, plus a new `browsePath`                          | [Discovery & Search](/ai-2-0/release-2.0/discovery-and-search)           | Breaking    |
| 7  | `/v1/agents/abilities` renamed to `/v1/agents/skills`, Knowledge Center and Context Memory APIs moved         | [AI Agents & Automations](/ai-2-0/release-2.0/ai-agents-and-automations) | Breaking    |
| 8  | AI Mode routes dropped the `/askCollate` prefix                                                               | [AI Mode](/ai-2-0/release-2.0/ai-mode)                                   | Breaking    |
| 9  | Credits are now **weighted by model and cache usage**, runs that cannot finish are refused                    | [Collate AI & Credits](/ai-2-0/release-2.0/collate-ai-and-credits)       | Behavioural |
| 10 | `maxActiveSessionsPerUser` defaults to 5, sessions are database-backed                                        | [Platform & Security](/ai-2-0/release-2.0/platform-and-security)         | Behavioural |
| 11 | **AskCollate is renamed to Collate AI** across UI, backend, billing labels and Slack/Teams                    | [Collate AI & Credits](/ai-2-0/release-2.0/collate-ai-and-credits)       | Breaking    |
| 12 | AI Dashboards enforce visibility, **every dashboard is set to Public** on upgrade                             | [AI Agents & Automations](/ai-2-0/release-2.0/ai-agents-and-automations) | Breaking    |
| 13 | An AI chart now belongs to **exactly one** dashboard: `dashboards[]` becomes `dashboard`                      | [AI Agents & Automations](/ai-2-0/release-2.0/ai-agents-and-automations) | Breaking    |
| 14 | Ingestion images move from **Python 3.10 to 3.12**                                                            | [Ingestion & Connectors](/ai-2-0/release-2.0/ingestion-and-connectors)   | Breaking    |
| 15 | Hybrid Runner and AI Platform images are **distroless**, no shell access                                      | [Platform & Security](/ai-2-0/release-2.0/platform-and-security)         | 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. New deployments should
  standardise on the Kubernetes Orchestrator. 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](/ai-2-0/release-2.0/ingestion-and-connectors).
</Warning>

## Browse by component

<CardGroup cols={2}>
  <Card title="AI Mode" icon="sparkles" href="/ai-2-0/release-2.0/ai-mode">
    The new AI-native interface, what is in it, and the three ways to enable it.
  </Card>

  <Card title="AI Agents & Automations" icon="robot" href="/ai-2-0/release-2.0/ai-agents-and-automations">
    Agent apps replaced by AI Automations, Skills, Context Plugins, AI Dashboards and AICharts.
  </Card>

  <Card title="Collate AI & Credits" icon="coins" href="/ai-2-0/release-2.0/collate-ai-and-credits">
    Conversation sharing and collaborators, plus the reworked credit and billing model.
  </Card>

  <Card title="Discovery & Search" icon="magnifying-glass" href="/ai-2-0/release-2.0/discovery-and-search">
    The redesigned Explore page, the browse-and-filter query bar and staged ranking.
  </Card>

  <Card title="Collaboration" icon="users" href="/ai-2-0/release-2.0/collaboration">
    Task redesign, Suggestions API removal, standalone Announcements and the Activity Stream.
  </Card>

  <Card title="Data Governance" icon="shield-halved" href="/ai-2-0/release-2.0/data-governance">
    Policies and task operations, glossary and ontology, classification, workflows, Data Access Requests and the Policy Agent.
  </Card>

  <Card title="Data Quality & Observability" icon="circle-check" href="/ai-2-0/release-2.0/data-quality">
    Incidents as Tasks, inlined incident status, auto-close and the removed Data Insights DQ module.
  </Card>

  <Card title="Lineage" icon="diagram-project" href="/ai-2-0/release-2.0/lineage">
    FQN-based edge APIs, batch hydration and time-window traversal semantics.
  </Card>

  <Card title="Ingestion & Connectors" icon="database" href="/ai-2-0/release-2.0/ingestion-and-connectors">
    pipelineStatuses, Databricks Pipeline auth, log-stream and progress payloads, Great Expectations 1.x and new connectors.
  </Card>

  <Card title="API & Schema" icon="code" href="/ai-2-0/release-2.0/api-and-schema">
    Removed endpoints, changed request and response shapes, tightened validation and enum changes.
  </Card>

  <Card title="Platform, Config & Security" icon="server" href="/ai-2-0/release-2.0/platform-and-security">
    llmConfiguration, session management, database timeouts and the 2.0.0 migration.
  </Card>

  <Card title="Platform Applications" icon="puzzle-piece" href="/ai-2-0/release-2.0/platform-applications">
    Search Indexing app config, RDF Index defaults, Data Insights module changes and MCP tool contracts.
  </Card>

  <Card title="UI & Customization" icon="palette" href="/ai-2-0/release-2.0/ui-and-customization">
    Design-system consolidation, per-user preferences and removed components.
  </Card>
</CardGroup>

## Upgrade checklist

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

  <Step title="Record your agent app configuration">
    The Documentation, Tier and Quality agent apps are deleted during the upgrade. Note their filters
    and schedules. The migration preserves the filter but the replacement automation arrives
    **disabled and unscheduled**.
  </Step>

  <Step title="Port your LLM configuration">
    The `elasticsearch.naturalLanguageSearch.*` provider blocks no longer exist. Move them to
    `llmConfiguration` before you upgrade or semantic search silently degrades.
  </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 these data migrations: suggestions and thread tasks into the Task entity, system feed
    threads into the Activity Stream, announcements into their own entity, agent apps into AI
    Automations, and the Data Access Request and AutoPilot workflows reseeded.
  </Step>

  <Step title="Allow a full search reindex">
    Reindexing in 2.0 always recreates the index. 2.0 has no incremental mode, and ranking
    configuration is backfilled during the migration.
  </Step>

  <Step title="Re-enable your migrated automations">
    Open **AI Automations**, find the entries suffixed **(migrated)**, review the carried-over filter,
    then enable and schedule each one.
  </Step>

  <Step title="Reissue tokens for removed agent bots">
    `CollateAIApplicationBot` and the Tier and Quality agent bots are deleted with their apps. Reissue
    any API or SDK token that used them.
  </Step>

  <Step title="Review AI Dashboard visibility">
    The upgrade sets every dashboard to **Public** to preserve access. Owners should restrict the ones
    that should not be org-wide.
  </Step>

  <Step title="Rebuild custom ingestion images">
    Ingestion moves to Python 3.12. `cp310` wheels will not load.
  </Step>

  <Step title="Decide your AI Mode rollout">
    Choose whether to leave the tenant default unset, pin a pilot persona to AI, or default everyone
    to AI Mode. See [AI Mode](/ai-2-0/release-2.0/ai-mode).
  </Step>
</Steps>

## Version scope

|                           |                                              |
| ------------------------- | -------------------------------------------- |
| **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 and renaming them here would make the instructions
  wrong.
</Note>