# OpenAPI Specification

EMS API to work with Knowledge Model elements, like records, kpis, filters and their related data.

Version: v1.32.0

## Servers

```
https://b0eca2bc-fbc3-400f-b855-9fe468151d15.remockly.com
```

## Security

### BearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

### ApiKeyAuth

Type: apiKey
In: header
Name: AppKey

## Download OpenAPI description

[OpenAPI Specification](https://developer.celonis.com/_bundle/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi.yaml)

## Schema

### Get a list of KMs

 - [GET /intelligence/api/knowledge-models](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/schema/getknowledgemodel.md): List of Knowledge Models defined in an EMS team

### Get the top-level KM details

 - [GET /intelligence/api/knowledge-models/{km_id}](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/schema/getknowledgemodeldetails.md): Knowledge Model defined in an EMS team

### Get a list of KM Filters

 - [GET /intelligence/api/knowledge-models/{km_id}/filters](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/schema/getfilters.md): List of Filters for the Knowledge Model

### Get a list of KM Records schema

 - [GET /intelligence/api/knowledge-models/{km_id}/records](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/schema/getrecords.md): List of Records schema

### Get the top-level KM Record Schema details

 - [GET /intelligence/api/knowledge-models/{km_id}/records/{record_id}](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/schema/getrecorddetails.md): Top-level Record Schema details

### Get a list of KM KPI's schema

 - [GET /intelligence/api/knowledge-models/{km_id}/kpis](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/schema/getkpis.md): List of KPI's schema.

## Data

### Get a list of KM data

 - [GET /intelligence/api/knowledge-models/{km_id}/data](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/data/getknowledgemodeldataresult.md): Data for a Knowledge Model

### Get a list of KM data with advanced filtering

 - [POST /intelligence/api/knowledge-models/{km_id}/data](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/data/getknowledgemodelqueryresultbyusingqueryinbody.md): Query Data for a Knowledge Model that is combining different Records, this endpoint allows clients to easily include more complicated queries.

### Get a list of KM Record data

 - [GET /intelligence/api/knowledge-models/{km_id}/records/{record_id}/data](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/data/getrecorddataresult.md): Data for a Record in the Knowledge Model.

### Get a list of KM Record data with advanced filtering

 - [POST /intelligence/api/knowledge-models/{km_id}/records/{record_id}/data](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/data/getrecorddataresultbyusingqueryinbody.md): Query Data for a Record in the Knowledge Model. This endpoint allows clients to easily include more complicated queries.

## Beta: Semantics for 3P AI Agents

### Get a list of KM Record data

 - [GET /intelligence/api/knowledge-models/{km_id}/records/{record_id}/query](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-semantics-for-3p-ai-agents/getrecordqueryresult.md): Query Data for a Record in the Knowledge Model.

### Get a list of KM data from different records

 - [GET /intelligence/api/knowledge-models/{km_id}/query](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-semantics-for-3p-ai-agents/getknowledgemodelqueryresult.md): Query Data for a Knowledge Model that is combining different Records

### Generate an OpenAPI spec from a Knowledge Model

 - [GET /intelligence/api/knowledge-models/{km_id}/spec](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-semantics-for-3p-ai-agents/getknowledgemodelspec.md): OpenaAPI spec of Knowledge Model

### Get KM record statistics - Only for Attributes

 - [GET /intelligence/api/knowledge-models/{km_id}/records/{record_id}/summary](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-semantics-for-3p-ai-agents/summaryresult.md): Knowledge Model record content statistics, only calculed for attributes. KPI and Flags will return empty results

## Beta: OData Protocol

### OData metadata endpoint

 - [GET /intelligence/api/odata/{km_id}.svc/$metadata](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-odata-protocol/odatametadataresult.md): OData Knowledge Model $metadata

### OData service definition endpoint

 - [GET /intelligence/api/odata/{km_id}.svc](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-odata-protocol/odataservicedefinitionresult.md): OData Knowledge Model service definition endpoint

### OData service data endpoint

 - [GET /intelligence/api/odata/{km_id}.svc/{record_id}_entries](https://developer.celonis.com/process-intelligence-apis/knowledge-model-api/api-reference/openapi/openapi/beta:-odata-protocol/odataservicedataresult.md): OData Knowledge Model service data endpoint