{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/process-intelligence-apis/knowledge-model-api/release-notes/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#changelog\" aria-label=\"changelog permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"changelog\"></div>Changelog</h1>\n<h2 style=\"position:relative;\"><a href=\"#nov-12-2024\" aria-label=\"nov 12 2024 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"nov-12-2024\"></div>Nov 12, 2024</h2>\n<ul>\n<li>\n<strong>Filter expressions</strong>\n according to \n<a href=\"https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_QueryOptions\">OData semantics</a>\n as described in the \n<a href=\"/process-intelligence-apis/knowledge-model-api/features/filtering-odata-typed/\">new filtering section</a>\n. 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 semantics 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 \n<a href=\"/process-intelligence-apis/knowledge-model-api/features/filtering/#differences-between-legacy-and-new-filter-expression-semantics\">here</a>\n. \n<h2 style=\"position:relative;\"><a href=\"#sep-16-2024\" aria-label=\"sep 16 2024 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"sep-16-2024\"></div>Sep 16, 2024</h2>\n</li>\n<li>\n<strong>Data retrieval at the Knowledge Model level</strong>\n (using attributes of different records - parameter  \n<code class=\"language-text\">fields</code>\n, Key Performance Indicator(s) - parameter \n<code class=\"language-text\">kpis</code>\n and fuzzy search capability - parameters \n<code class=\"language-text\">seachTerm</code>\n,\n<code class=\"language-text\">searchField</code>\n and \n<code class=\"language-text\">seacrhPrecision</code>\n).\n<h2 style=\"position:relative;\"><a href=\"#aug-19-2024\" aria-label=\"aug 19 2024 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"aug-19-2024\"></div>Aug 19, 2024</h2>\n</li>\n<li>\n<strong>Odata protocol</strong>\n for the Knowledge Model API released in beta, with one root service per Knowledge Model, metadata service and Knowledge Model record data retrieval supporting query options: \n<code class=\"language-text\">$top</code>\n, \n<code class=\"language-text\">$skip</code>\n, \n<code class=\"language-text\">$select</code>\n, \n<code class=\"language-text\">$orderby</code>\n, \n<code class=\"language-text\">$count=true</code>\n and \n<code class=\"language-text\">$filter</code>\n \n<h2 style=\"position:relative;\"><a href=\"#jul-31-2024\" aria-label=\"jul 31 2024 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"jul-31-2024\"></div>Jul 31, 2024</h2>\n</li>\n<li>\nSelect the \n<strong>distinct</strong>\n option for data retrieval using the \n<code class=\"language-text\">options=distinct</code>\n parameter.\n<h2 style=\"position:relative;\"><a href=\"#jul-22-2024\" aria-label=\"jul 22 2024 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"jul-22-2024\"></div>Jul 22, 2024</h2>\n<p><strong>Semantic extension endpoints for 3P Agents</strong>, including: </p>\n</li>\n<li>\nOpenAPI spec endpoint per Knowledge Model (\n<code class=\"language-text\">intelligence/api/knowledge-models/{{km-id}}/spec</code>\n),\n</li>\n<li>\nKnowledge Model record query endpoint (\n<code class=\"language-text\">intelligence/api/knowledge-models/{{km-id}}/records/{{record-id}}/query</code>\n) and\n</li>\n<li>\nKnowledge Model record column statistics summary endpoint (\n<code class=\"language-text\">intelligence/api/knowledge-models/{{km-id}}/records/{{record-id}}/summary</code>\n).\n<h2 style=\"position:relative;\"><a href=\"#mar-14-2024\" aria-label=\"mar 14 2024 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"mar-14-2024\"></div>Mar 14, 2024</h2>\n</li>\n<li>\nFiltering by date bug fixed.\n<h2 style=\"position:relative;\"><a href=\"#dec-18-2023\" aria-label=\"dec 18 2023 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"dec-18-2023\"></div>Dec 18, 2023</h2>\n</li>\n<li>\nChecks for parameter pollution and tampering from malicious characters in \n<code class=\"language-text\">intelligence/api/knowledge-models/{{km-id}}/records/{{record-id}}/data</code>\n endpoint.\n<h2 style=\"position:relative;\"><a href=\"#nov-16-2023\" aria-label=\"nov 16 2023 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"nov-16-2023\"></div>Nov 16, 2023</h2>\n</li>\n<li>\nInvalid parameter values are no longer echoed in error messages for security reasons.\n<h2 style=\"position:relative;\"><a href=\"#sep-22-2023\" aria-label=\"sep 22 2023 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"sep-22-2023\"></div>Sep 22, 2023</h2>\n</li>\n<li>\nCapability to use filter expression predicates such as \n<code class=\"language-text\">in</code>\n, \n<code class=\"language-text\">contains()</code>\n, \n<code class=\"language-text\">startswith()</code>\n, and \n<code class=\"language-text\">endswith()</code>\n added.\n<h2 style=\"position:relative;\"><a href=\"#jul-12-2023\" aria-label=\"jul 12 2023 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"jul-12-2023\"></div>Jul 12, 2023</h2>\n</li>\n<li>\nCapability to use logical operators in filter expressions added.\n<h2 style=\"position:relative;\"><a href=\"#jun-14-2023\" aria-label=\"jun 14 2023 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"jun-14-2023\"></div>Jun 14, 2023</h2>\n</li>\n<li>\nNumber of fields per data set increased from 20 to 200.\n</li>\n<li>\nResult data values are typed according to KM record field types.\n<h2 style=\"position:relative;\"><a href=\"#apr-10-2023\" aria-label=\"apr 10 2023 permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"apr-10-2023\"></div>Apr 10, 2023</h2>\n</li>\n<li>\nCapability to filter by augmented attributes and flags added.\n</li>\n</ul>","headings":[{"value":"Changelog","depth":1},{"value":"Nov 12, 2024","depth":2},{"value":"Sep 16, 2024","depth":2},{"value":"Aug 19, 2024","depth":2},{"value":"Jul 31, 2024","depth":2},{"value":"Jul 22, 2024","depth":2},{"value":"Mar 14, 2024","depth":2},{"value":"Dec 18, 2023","depth":2},{"value":"Nov 16, 2023","depth":2},{"value":"Sep 22, 2023","depth":2},{"value":"Jul 12, 2023","depth":2},{"value":"Jun 14, 2023","depth":2},{"value":"Apr 10, 2023","depth":2}]},"contentItem":{"data":{"lastModified":"2025-10-07T16:52:38.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"daf1bf68-c82a-5e04-ae1a-a0c379f0eebd__redocly content/process-intelligence-apis/knowledge-model-api/release-notes/","seo":{"title":"Changelog","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/knowledge-model-api/release-notes.md","pageBaseUrl":"/process-intelligence-apis/knowledge-model-api/release-notes","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Changelog","id":"changelog"},{"depth":2,"value":"Nov 12, 2024","id":"nov-12-2024"},{"depth":2,"value":"Sep 16, 2024","id":"sep-16-2024"},{"depth":2,"value":"Aug 19, 2024","id":"aug-19-2024"},{"depth":2,"value":"Jul 31, 2024","id":"jul-31-2024"},{"depth":2,"value":"Jul 22, 2024","id":"jul-22-2024"},{"depth":2,"value":"Mar 14, 2024","id":"mar-14-2024"},{"depth":2,"value":"Dec 18, 2023","id":"dec-18-2023"},{"depth":2,"value":"Nov 16, 2023","id":"nov-16-2023"},{"depth":2,"value":"Sep 22, 2023","id":"sep-22-2023"},{"depth":2,"value":"Jul 12, 2023","id":"jul-12-2023"},{"depth":2,"value":"Jun 14, 2023","id":"jun-14-2023"},{"depth":2,"value":"Apr 10, 2023","id":"apr-10-2023"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/knowledge-model-api/release-notes/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}