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

Frequently Asked Questions (FAQ)

\n

Requests to Subscription APIs 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 above error message 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

In order 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

How can I recover a failed subscription?

\n

It can automatically recover when the destination webhook starts accepting Celonis messages. Alternatively, the consumer can recover the subscription by submitting new callback details (webhook URI or credentials). The failed messages are not lost; they are emitted after the communication is restored (unless the subscription has been configured to skip errors).

\n

How can I recover a suspended subscription?

\n

A suspended subscription can only be recovered by updating the subscription with new callback details. The failed messages are permanently lost.

\n

What can I do to retrieve messages from a failing subscription?

\n

There are two ways:

\n
    \n
  1. \nPerforming reconciliation and retrieving synchronously the failed messages (method \nPATCH subscriptions/{subscription_id}/events\n).\n
    2. \n
  2. \nReplaying the messages from the last successful offset (method \nPATCH subscriptions/{subscription_id}/replay\n).\n
    3. \n
","headings":[{"value":"Frequently Asked Questions (FAQ)","depth":1},{"value":"Requests to Subscription APIs are blocked by the browser CORS policy. What do I do?","depth":2},{"value":"How can I recover a failed subscription?","depth":2},{"value":"How can I recover a suspended subscription?","depth":2},{"value":"What can I do to retrieve messages from a failing subscription?","depth":2}]},"contentItem":{"data":{"lastModified":"2025-01-27T15:25:44.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"bcdb94fd-37d4-5bed-a6e2-e12c83e844de__redocly content/process-intelligence-apis/subscription-api/faq/","seo":{"title":"Frequently Asked Questions (FAQ)","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/subscription-api/faq.md","pageBaseUrl":"/process-intelligence-apis/subscription-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 Subscription APIs are blocked by the browser CORS policy. What do I do?","id":"requests-to-subscription-apis-are-blocked-by-the-browser-cors-policy-what-do-i-do"},{"depth":2,"value":"How can I recover a failed subscription?","id":"how-can-i-recover-a-failed-subscription"},{"depth":2,"value":"How can I recover a suspended subscription?","id":"how-can-i-recover-a-suspended-subscription"},{"depth":2,"value":"What can I do to retrieve messages from a failing subscription?","id":"what-can-i-do-to-retrieve-messages-from-a-failing-subscription"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/subscription-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"]}