{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"BPMN API (Legacy)","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"],"excludeFiles":[]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"bpmn-api-legacy","__idx":0},"children":["BPMN API (Legacy)"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The legacy APIs in this section are not recommended for new implementations. It is recommended that you use the APIs from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cpm/developer/openapi/openapi"},"children":["Business Manager"]}," section for your integrations with the Celonis Platform."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this API to generate BPMN files for given processes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can access the Swagger definition of these APIs using this URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://pz.symbioweb.com/swagger/index.html?url=/swagger/v1/swagger.json"]},". Just replace ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pz.symbioweb.com"]}," with the hostname (and port) of your  instance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is also recommended to use Refit for building corresponding requests. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/reactiveui/refit"},"children":["the refit repository"]}," for further information."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scenarios","__idx":1},"children":["Scenarios"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," endpoint to create a BPMN XML definition for a given process-element: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://pz.symbioweb.com/swagger/index.html?url=/swagger/v1/swagger.json#/BPMN%20Api%20(Version%201)/BpmnV1_Export"]},", e.g."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET https://pz.symbioweb.com/Collection/Storage/_api/v1/bpmn/f4bacd71-b8fb-48f9-9221-076a98ce8e15?lcid=0&symbio-auth-token=07hke7cywmknzdu7f3fcn64qv1\n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST"]}," endpoint to import the BPMN which is posted to this endpoint: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://pz.symbioweb.com/swagger/index.html?url=/swagger/v1/swagger.json#/BPMN%20Api%20(Version%201)/BpmnV1_Export"]},", e.g."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST https://pz.symbioweb.com/Collection/Storage/_api/v1/bpmn/f4bacd71-b8fb-48f9-9221-076a98ce8e15?lcid=0&symbio-auth-token=07hke7cywmknzdu7f3fcn64qv1\n"},"children":[]}]}]}]},"headings":[{"value":"BPMN API (Legacy)","id":"bpmn-api-legacy","depth":1},{"value":"Scenarios","id":"scenarios","depth":2}],"frontmatter":{"seo":{"title":"BPMN API (Legacy)"}},"lastModified":"2026-06-16T21:43:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/cpm/developer/rest-api/overview/bpmn-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}