{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/process-intelligence-apis/knowledge-model-api/faq/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Frequently Asked Questions (FAQ)

\n

Requests to the AI API are blocked by the browser CORS policy. What do I do?

\n

When facing this issue, you will see a CORS error like the one below:

\n
\n
\n
Copy
\n
Copied
\n
\n 
Access to XMLHttpRequest from origin 'http://localhost:4200' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.
\n
\n

This error occurs when the browser is trying to make a request to a different origin (domain) than the one it's hosted\non and the server the request is being sent to is not configured to allow cross-origin requests.\nThe Access-Control-Allow-Origin header is used to specify which origins are allowed to access the resource. If this\nheader is not present, the browser will block the request and the error message above will be displayed.

\n

Unfortunately, for security reasons, we can't add \"localhost\" to the response 'Access-Control-Allow-Origin' HTTP header,\nso this issue must be solved from the API consumer side.

\n

To solve this problem, we recommend using a REST client instead of a web browser. This would also ease the\nprocess of setting the proper HTTP Authorization headers as part of your requests.

\n

Can I retrieve any Knowledge Model item available in the Celonis Platform through the Knowledge Model API?

\n

No, you will not be able to retrieve all the Knowledge Model items available in the Celonis Platform. For reference,\nthe Knowledge Model API currently supports:

\n\n

How do I retrieve Knowledge Model KPIs through the API?

\n

There are two ways to retrieve KPIs via the Knowledge Model API:

\n
    \n
  1. \nUsing the data retrieval endpoint at the KM level (\nGET intelligence/api/knowledge-models/{km-id}/data\n) and the \nkpis\n parameter.\n
    2. \n
  2. \nUsing the data retrieval endpoint at the KM record level (\nGET intelligence/api/knowledge-models/{km-id}/records/{record-id}/data\n) when one of the record attributes is equal to a KPI and this attribute is selected using \nfields\n parameter.\n
    3. \n
\n

Is it possible to pull data from multiple Knowledge Model records with a single Knowledge Model API call?

\n

Yes, using the data retrieval endpoint at the KM level (GET intelligence/api/knowledge-models/{km-id}/data), you can combine attributes from different records in the fields parameter (using the notation record-id.field-id) along with KPIs in the kpis parameter.

\n

Example:

\n

Call

\n
\n
\n
Copy
\n
Copied
\n
\n 
GET intelligence/api/knowledge-models/ocpm-procurement-starter-kit-store.ocpm-procurement-km/data?fields=O_CELONIS_VENDOR.NAME,O_CELONIS_VENDOR.COUNTRY,O_CELONIS_VENDOR.CITY,O_CELONIS_CONTRACT.ID&options=distinct&kpis=KPI_PO_ITEM_CONTRACT_USAGE_VALUE_RATE
\n
\n

Result:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n   \"page\": 0,\n   \"pageSize\": 20,\n   \"total\": 1,\n   \"sort\": [],\n   \"content\": {\n        \"headers\": [\n            {\n                \"id\": \"O_CELONIS_VENDOR.NAME\",\n                \"name\": \"Name\",\n                \"type\": \"string\",\n                \"format\": null,\n                \"unit\": null,\n                \"aggregation\": false,\n                \"filterable\": true,\n                \"sortable\": true\n            },\n            {\n                \"id\": \"O_CELONIS_VENDOR.COUNTRY\",\n                \"name\": \"Country\",\n                \"type\": \"string\",\n                \"format\": null,\n                \"unit\": null,\n                \"aggregation\": false,\n                \"filterable\": true,\n                \"sortable\": true\n            },\n            {\n                \"id\": \"O_CELONIS_VENDOR.CITY\",\n                \"name\": \"City\",\n                \"type\": \"string\",\n                \"format\": null,\n                \"unit\": null,\n                \"aggregation\": false,\n                \"filterable\": true,\n                \"sortable\": true\n            },\n            {\n                \"id\": \"O_CELONIS_CONTRACT.ID\",\n                \"name\": \"Id\",\n                \"type\": \"string\",\n                \"format\": null,\n                \"unit\": null,\n                \"aggregation\": false,\n                \"filterable\": true,\n                \"sortable\": true\n            },\n            {\n                \"id\": \"KPI_PO_ITEM_CONTRACT_USAGE_VALUE_RATE\",\n                \"name\": \"Contract Usage rate [%EUR]\",\n                \"type\": \"float\",\n                \"format\": \",.1%\",\n                \"unit\": null,\n                \"aggregation\": true,\n                \"filterable\": false,\n                \"sortable\": true\n            }\n        ],\n        \"data\": [\n            {\n                \"O_CELONIS_VENDOR.COUNTRY\": \"DE\",\n                \"O_CELONIS_CONTRACT.ID\": \"Contract_8004700114202\",\n                \"O_CELONIS_VENDOR.NAME\": \"ACDA TYRES\",\n                \"KPI_PO_ITEM_CONTRACT_USAGE_VALUE_RATE\": 1.0,\n                \"O_CELONIS_VENDOR.CITY\": \"Bremen\"\n            }\n       ]\n   }\n}
\n
","headings":[{"value":"Frequently Asked Questions (FAQ)","depth":1},{"value":"Requests to the AI API are blocked by the browser CORS policy. What do I do?","depth":2},{"value":"Can I retrieve any Knowledge Model item available in the Celonis Platform through the Knowledge Model API?","depth":2},{"value":"How do I retrieve Knowledge Model KPIs through the API?","depth":2},{"value":"Is it possible to pull data from multiple Knowledge Model records with a single Knowledge Model API call?","depth":2}]},"contentItem":{"data":{"lastModified":"2025-11-06T18:38:03.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"a8dd55bd-83b6-599c-969c-1290d64fcaee__redocly content/process-intelligence-apis/knowledge-model-api/faq/","seo":{"title":"Frequently Asked Questions (FAQ)","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/knowledge-model-api/faq.md","pageBaseUrl":"/process-intelligence-apis/knowledge-model-api/faq","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Frequently Asked Questions (FAQ)","id":"frequently-asked-questions-faq"},{"depth":2,"value":"Requests to the AI API are blocked by the browser CORS policy. What do I do?","id":"requests-to-the-ai-api-are-blocked-by-the-browser-cors-policy-what-do-i-do"},{"depth":2,"value":"Can I retrieve any Knowledge Model item available in the Celonis Platform through the Knowledge Model API?","id":"can-i-retrieve-any-knowledge-model-item-available-in-the-celonis-platform-through-the-knowledge-model-api"},{"depth":2,"value":"How do I retrieve Knowledge Model KPIs through the API?","id":"how-do-i-retrieve-knowledge-model-kpis-through-the-api"},{"depth":2,"value":"Is it possible to pull data from multiple Knowledge Model records with a single Knowledge Model API call?","id":"is-it-possible-to-pull-data-from-multiple-knowledge-model-records-with-a-single-knowledge-model-api-call"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/knowledge-model-api/faq/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}