Operate Public API (Self-Managed)
Number of APIs: 19
💪 What do you need to make it work?
Authentication for Self-Managed cluster​
Authentication via Identity JWT access token​
This authentication method is described in Operate Configuration - Authentication.
Authentication via cookie​
Another way to access the Operate API in a Self-Managed cluster is to send cookie headers in each request. The cookie can be obtained by using the API endpoint /api/login
. Take the steps in the following example:
Example:
- Log in as user 'demo' and store the cookie in the file
cookie.txt
.
curl -c cookie.txt -X POST 'http://localhost:8080/api/login?username=demo&password=demo'
- Send the cookie (as a header) in each API request. In this case, request all process definitions.
curl -b cookie.txt -X POST 'http://localhost:8080/v1/process-definitions/search' -H 'Content-Type: app
Set variables
baseUrlOperateLocal: URL of your Self-Managed deployment. Default is
localhost:8081
. If this doesn't work, check your ports mapping and define it in the global or environment scope.apiVersion: Currently supported and default is
v1
- define this in the global or environment scope.username and password: Change it if different than
demo/demo
in collection variables.
Your Operate API is now up and running in Self-Managed mode, and you can execute API requests.
-
Process definitions - Get process definition by key GET {{baseUrl+ApiVersion}}/process-definitions/:key
-
Process definitions - Search for process definitions POST {{baseUrl+ApiVersion}}/process-definitions/search
-
Process definitions - Get process defintion by key as XML GET {{baseUrl+ApiVersion}}/process-definitions/:key/xml
-
Process instances - Search for process instances POST {{baseUrl+ApiVersion}}/process-instances/search
-
Process instances - Get process instance by key GET {{baseUrl+ApiVersion}}/process-instances/:key
-
Variables - Search for variables POST {{baseUrl+ApiVersion}}/variables/search
-
Process instances - Delete process instance and dependant data by key DELETE {{baseUrl+ApiVersion}}/process-instances/:key
-
Incidents - Search for incidents POST {{baseUrl+ApiVersion}}/incidents/search
-
Incidents - Get incident by key GET {{baseUrl+ApiVersion}}/incidents/:key
-
Flow node instances - Search for flow node instances POST {{baseUrl+ApiVersion}}/flownode-instances/search