Skip to main content

Celonis Product Documentation

Data Job Execution API

Using a RESTful API you can trigger a Data Job execution in the following way:

POST /integration/api/v2/data-pools/{poolId}/data-jobs/{jobId}/execute?mode={mode}
Bildschirmfoto_2022-11-07_um_18_30_39.png

To use the API you need three pieces of information:

  1. Data Pool ID

  2. Data Job ID

  3. Mode of the Data Job, this can be FULL for a full load or DELTA for a delta load

The first two can be retrieved from the URL of the Data Job (see screenshot).

This is an example how this API can be used in Python:

import requests

tenant = 'xyz' # the name of your team (your subdomain)
realm = 'xyz' # e.g. eu-1, us-1, eu-2
api_key = 'xyz' # the API key
pool_id = 'xyz' # the Data Pool ID (see above)
data_job_id = 'xyz' # the Data Job ID (see above)
data_job_mode = 'DELTA' # the mode of the Data Job (see above)

url = "https://{}.{}.celonis.cloud/integration/api/v1/data-pools/{}/data-jobs/{}/execute?mode={}".format(tenant, realm, pool_id, data_job_id, data_job_mode)

requests.post(url, headers={'authorization': "Bearer {}".format(api_key)})