style

r { color: Red }
o { color: Orange }
y { color: Grey }
g { color: Green }

# Changelog

## May 13, 2026

### Celonis Audit Log API and Celonis Platform Adoption API - Version 2.0

#### [Update]

Version 2.0 of the Celonis Audit Log and Celonis Platform Adoption APIs has been released. With this new version, both APIs now offer token-based/cursor-based pagination. The request parameters in Version 2.0 include `pageToken` and `limit`, with `limit` having a default value of "200", a minimum of "1", and a maximum of "500". The response models for both new versions return cursor-based data that includes a `nextPageToken`.

Note
Version 1.0 of these APIs will coninue to be supported, but will be deprecated in the future. It is recommended that Version 2.0 is used in all new implementations.

The new versions of these APIs provide:

* Better performance for large datasets.
* More stable pagination when new events are ingested.
* Higher per-request limit support (up to 500 records).


For more information, see [Celonis Audit Log API (v2.0)](/celonis-apis/audit-log-api/openapi/openapi-external-v2) and [Celonis Platform Adoption API (v2.0)](/celonis-apis/platform-api/openapi/openapi-external-v2).

## Mar 23, 2026

### Process Intelligence APIs - AI API

#### [Feature]

We’ve updated the AI API to support Structured Outputs! You can now configure Process Copilot to return specific JSON
data alongside standard text responses. This makes it easier to trigger Action Flows or update UI components directly
from an Agent's response.

Check the updated endpoint: [Conversation Endpoint](https://developer.celonis.com/process-intelligence-apis/agents-api/api-reference/openapi/reference/operation/pushConversations/).

## Mar 13, 2026

### Process Intelligence APIs - Event Subscription API

#### [Security Update]

We're enhancing the security of your integration with the Event Subscription API. Previously it used a singular `intelligence.subscriptions:manage` scope.
To ensure that integrations have access only to the resources they truly need this is the list of scopes required currently:

- `intelligence.subscriptions:manage`
- `triggers:read` & `triggers:manage`
- `knowledge-models:query`


You can find the required scopes defined in the updated documentation: [Getting Started](https://developer.celonis.com/process-intelligence-apis/subscription-api/get-started/getting-started/#authorization)

## Feb 19, 2026

### Agent Tools (MCP) Asset

#### [Feature]

- The **Agent Tools (MCP) Asset** has been released in General Availability (GA).
- This asset was formerly named the Model Context Protocol (MCP) Server Asset and was released into Private Preview in November of 2025.
- This feature enables AI agents to securely access and interact with Celonis data and insights through the Model Context Protocol.
- Provides ready-to-use tools that AI agents can use to search for relevant information, get real-time process context, trigger actions in external systems, and write decisions back to Celonis.


For more information, see the [Agent Tools (MCP) Asset Overview](https://developer.celonis.com/mcp-server-asset/overview/).

## Feb 17, 2026

### Process Intelligence APIs - AI API

#### [Update]

* We have refined how the Chat API is enabled to improve security and visibility.
* You must now enable the External Use in the Process Copilot asset in Studio to connect the Process Copilot to third-party applications via this API.
* Check the updated [Getting Started](https://developer.celonis.com/process-intelligence-apis/agents-api/get-started/getting-started/#prerequisites) page for the full enablement checklist.


## Feb 11, 2026

### Process Intelligence APIs - AI API

#### [Update]

* The Tools API has been removed from the AI API portfolio. To expose Celonis data retrieval and actions to third-party platforms like Microsoft Copilot Studio or Agentforce, please use the new MCP Server Asset in Studio. This provides a more secure, standardized way to integrate Process Intelligence into your AI ecosystem via the Model Context Protocol.
* For more information, see the [MCP Server Asset Overview](https://developer.celonis.com/mcp-server-asset/overview/).


## Feb 4, 2026

### Platform Usage APIs - Permissions API

#### [Feature]

* The **Permissions API** has been released in General Availability (GA).
* This API enables you to query permissions for a Celonis Platform team and then extract this data to provide insights into access management for your team.
* The extracted permissions data can be imported into the Celonis Platform as a data model and then used to create custom views in Studio.


For more information, see [Permissions API](/celonis-apis/permissions-api/overview).

## Nov 3, 2025

### Model Context Protocol (MCP) Server Asset

#### [Feature]

- The **Agent Tools (MCP) Asset** has been released in Private Preview.
- This feature enables AI agents to securely access and interact with Celonis data and insights through the Model Context Protocol.
- Provides ready-to-use tools that AI agents can use to search for relevant information, get real-time process context, trigger actions in external systems, and write decisions back to Celonis.


For more information, see the [MCP Server Asset Overview](https://developer.celonis.com/mcp-server-asset/overview/).

## Oct 9, 2025

### Process Intelligence APIs - Knowledge Model API

#### [Information]

- The **Intelligence API** has been renamed to the **[Knowledge Model API](https://knowledge-model-api-developer-portal-refactor.redoc.ly/process-intelligence-apis/knowledge-model-api/overview/)**! This is a name-only change, you can continue using the API as usual - all functionality remains the same.


## Sep 22, 2025

### Data Ingestion API - Standard Data Ingestion API

#### [Feature]

- The **Standard Data Ingestion API** has been released in General Availability (GA).


## Sep 8, 2025

### Celonis Process Management - Reporting API

#### [Feature]

- The **Reporting API** for Celonis Process Management has been released in General Availability (GA).
- The [Reporting API](https://developer.celonis.com/cpm/reporting/overview/) enables you to retrieve elements from your reporting database based on Process Designer data.
- This API also allows you to build reports and dashboards based on the CPM data in your 3rd party analytics tools.


## Aug 26, 2025

### Process Intelligence APIs - Intelligence API

#### [Feature]

Great news! We've just released two new endpoints in private preview: **[POST for KM Data Query](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/reference/operation/getKnowledgeModelQueryResultByUsingQueryInBody/)** and **[POST for KM Record Data Query](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/reference/operation/getRecordDataResultByUsingQueryInBody/)** within the **Intelligence API**.

This will directly address the challenges you've faced with URL length limitations when sending query parameters like `filterExpr`. Now, instead of breaking down large queries into many smaller requests, you can send all your query parameters (including lengthy filter expressions, pagination, and other components) within the request body.

This means you can:

- Make single, comprehensive requests for large datasets.
- Simplify your integration logic by removing the need for complex manual batching and result aggregation.
Please note that this solution only supports the new [OData semantics](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/features/filtering-odata-typed/); legacy filtering methods are no longer supported. Filter expressions are limited only by PQL and payload length.


Please contact your account team to get early access.

## Jul 10, 2025

### Process Intelligence APIs

#### [Security Update]

We're enhancing the security of your integrations with the Process Intelligence APIs by introducing
**new, granular OAuth 2.0 scopes**, providing more precise control over integration authorizations.

Previously, the Process Intelligence APIs used a singular `studio` scope, which granted broad permissions.
With this update, we are moving to a more refined system of **granular scopes**. These new scopes allow
you to define specific permissions for different actions within the Process Intelligence APIs, ensuring
that integrations only have access to the resources they truly need.

You can find the required scopes defined in the updated documentation for all our APIs:

- [New scopes for Intelligence API](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/get-started/getting-started/#oauth-scopes-for-knowledge-model-api)
- [New scopes for Event Subscriptions API](https://developer.celonis.com/process-intelligence-apis/subscription-api/get-started/getting-started/#oauth-scopes-for-subscription-api)
- [New scopes for AI APIs](https://developer.celonis.com/process-intelligence-apis/agents-api/get-started/getting-started/#oauth-scopes-for-ai-api)


Please, if you are using OAuth, ensure you set the required scope permissions in your OAuth Client.

API Keys will be deprecated in the coming months (as previously communicated to our customers),
and we will provide ample time for you to migrate existing solutions. Find here a guide about [How to
migrate applications calling Celonis APIs to OAuth 2.0 from API/Application keys](https://developer.celonis.com/celonis-apis/migrating-to-oauth/#migrating-applications-calling-celonis-apis-to-oauth-20-from-apiapplication-keys)

## Jul 1, 2025

### Process Intelligence APIs - Intelligence API

#### [Information]

- The 5,000 row limit per data set has been removed from the data retrieval endpoints [Get a list of KM data](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/reference/operation/getKnowledgeModelDataResult/) and [Get a list of KM Record data](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/reference/operation/getRecordDataResult/). Please read our updated [Terms and Conditions](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/terms/).


## Jun 13, 2025

### Process Intelligence APIs - Intelligence API

#### [Bug Fix]

- Fixed incorrect handling of dots in filter expression parameter literals


## Jun 5, 2025

### Process Intelligence APIs - Event Subscription API

#### [Feature]

- A new value of subscription status `rejected` was introduced to indicate that the events, although transmitted, were rejected by the recipient due to logical or configurational problems. Action is required from the consumer side to recover the subscription. Please read more [here](https://developer.celonis.com/process-intelligence-apis/subscription-api/overview/).


## Apr 29, 2025

### All APIs

#### [Feature]

- OAuth2.0 client with `grant_type=authorization_code` has now been released in private preview. Please contact your account team to get early access.


### Process Intelligence APIs - Event Subscription API

#### [Feature]

- The **Subscription API** subdomain has now been released in General Availability (GA).


### Process Intelligence APIs - AI API

#### [Feature]

- The **Chat API** AI subdomain has now been released in public preview.


## Jan 28, 2025

### Process Intelligence APIs - AI API

#### [Feature]

- A new AI subdomain has been added to the Process Intelligence APIs family in private preview. Please contact your account team to get early access.
- The **AI Subdomain** contains:
  - The **Chat API** to interact with a Process Copilot built in Celonis (as described here).
  - The **Tools API** to access data retrieval Tools built in Process Copilot. These tools can be called within any Agent platform (as described here).


## Nov 29, 2024

### Process Intelligence APIs - Event Subscription API

#### [Feature]

- **Replay** subscription capability allowing a consumer to receive again events from Celonis event queues starting from any offset (details [here](https://developer.celonis.com/process-intelligence-apis/subscription-api/api-reference/openapi/reference/operation/replaySubscriptionFromAnOffset/)).


## Nov 12, 2024

### Process Intelligence APIs - Intelligence API

#### [Feature: Breaking Change]

- **Filter expressions** according to [OData syntax](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_QueryOptions) as described in the [new filtering section](/process-intelligence-apis/knowledge-model-api/features/filtering-odata-typed). Existing customers are behind a legacy filtering feature flag and are not affected. Your account and value teams will contact you to guide you on how to change the filter expression syntax you are currently using. The legacy version will be removed at the end of May 2025. Differences between the new filtering capabilities and the legacy filtering are described [here](/process-intelligence-apis/knowledge-model-api/features/filtering#differences-between-legacy-and-new-filter-expression-syntax).


## Nov 11, 2024

### Process Intelligence APIs - Event Subscription API

#### [Feature]

- Return a JSON object upon Trigger subscription creation including the subscription Id (which in the sequel will be used to manage the subscription lifecycle).
- Event contract introduced and published [Outbound Webhook API Reference](/assets/reference.page.bc1a1013070821a46f4aaf0de67e1c18e77e3048f2fda16c1964d44e72ff40e4.e0406b5b.yaml).


## Nov 07, 2024

### Process Intelligence APIs - Event Subscription API

#### [Security Update]

- Introduction of the concept of **subscription ownership**: Only the subscription owner or administrators are allowed to manage the subscription lifecycle.


## Sep 20, 2024

### Process Intelligence APIs - Event Subscription API

#### [Feature]

- Spontaneous event is now structured as JSON object (not flat text with escaped JSON any longer)
- Event Queue Offset is published at subscription metadata and in forwarded events


## Sep 16, 2024

### Process Intelligence APIs - Intelligence API

#### [Feature]

- **Data retrieval at Knowledge Model level** (using attributes of different records - parameter  `fields`, Key Performance Indicator(s) - parameter `kpis` and fuzzy search capability - parameters `searchTerm`,`searchField` and `searchPrecision`).


## Aug 19, 2024

### Process Intelligence APIs - Intelligence API

#### [Beta Feature]

- **Odata protocol** for Intelligence API released in beta, with one root service per Knowledge Model, metadata service and Knowledge Model record data retrieval supporting query options: `$top`, `$skip`, `$select`, `$orderby`, `$count=true` and `$filter`


## Jul 31, 2024

### Process Intelligence APIs - Intelligence API

#### [Feature]

- Select **distinct** option for data retrieval using the parameter `options=distinct`.


## Jul 22, 2024

### Process Intelligence APIs - Intelligence API

#### [Beta Feature]

**Semantic extension endpoints for 3P Agents**, including:

- OpenAPI spec endpoint per Knowledge Model (`intelligence/api/knowledge-models/{{km-id}}/spec`),
- Knowledge Model record query endpoint (`intelligence/api/knowledge-models/{{km-id}}/records/{{record-id}}/query`) and
- Knowledge Model record column statistics summary endpoint (`intelligence/api/knowledge-models/{{km-id}}/records/{{record-id}}/summary`).


## Jun 26, 2024

### Process Intelligence APIs - Event Subscription API

#### [Changes in downstream services]

- New generation of **record-less triggers** supported


## Apr 29, 2024

### Process Intelligence APIs - Event Subscription API

#### [Feature]

- Subscriptions with configuration to skip errors introduced
- Resume without history operation added
- Last successfully emitted event timestamp added to subscription metadata


## Mar 14, 2024

### Process Intelligence APIs - Intelligence API

#### [Bug Fix]

- Filtering by date bug


## Dec 18, 2023

### Process Intelligence APIs - Intelligence API

#### [Security Update]

- Checks for parameter pollution and tampering from malicious characters in `intelligence/api/knowledge-models/{{km-id}}/records/{{record-id}}/data` endpoint.


## Nov 16, 2023

### Process Intelligence APIs - Intelligence API

#### [Security Update]

- Invalid parameter values are no longer echoed in error messages for security reasons.


## Sep 22, 2023

### Process Intelligence APIs - Intelligence API

#### [Feature]

- Capability to use filter expression predicates like `in`, `contains()`, `startswith()`, `endswith()` added.


## Jul 12, 2023

### Process Intelligence APIs - Intelligence API

#### [Feature]

- Capability to use logical operators in filter expressions added.


## Jun 14, 2023

### Process Intelligence APIs - Intelligence API

#### [Bug Fix]

- Number of fields per data set increased from 20 to 200.
- Result data values are typed according to KM record field types.


## Apr 10, 2023

### Process Intelligence APIs - Intelligence API

#### [Feature]

- Capability to filter by augmented attributes and flags added.