{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Getting Started","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":"getting-started","__idx":0},"children":["Getting Started"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Data Push API is not recommended for new implementations. We recommend that you use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/data-ingestion-api/standard/standard_overview"},"children":["Data Ingestion API"]}," to pull your data into the Celonis Platform."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page describes how to get started with the Data Push API in a simple way using Postman."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Data Push API provides an easy way to transfer data into Celonis. For pushing data, Celonis currently uses micro-batching. Instead of either inserting huge chunks all at once or inserting record by record, data meant to be pushed into the platform is structured into these so-called \"micro-batches\". As an exchange format, the commonly used Parquet or CSV file formata are used. The API provides an easy way of creating, executing, and monitoring micro-batch jobs/Data Push jobs. Once the data is available in the system, you can transform, analyze and work with it as you would with a Celonis-provided extractor."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How it works"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creating a Data Push job defines which Data Pool, Data Connection target table data should be pushed into."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You send data to Celonis by adding chunks, either Parquet (preferred) or CSV to a Data Push job."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit a Data Push job by calling the execute Data Push Job endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the status of the Data Push Job by calling the list Data Push Jobs endpoint."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-limits","__idx":2},"children":["API Limits:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There is a 1 GB data limit on each data chunk. In general, splitting data into chunks smaller than 1 GB makes sense. For a push job as a whole which can contain multiple chunks, there is no data limit."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API to submit a push job is rate limited on a team basis. These limits are fixed to guarantee platform stability for all of our customers:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["10 requests/second"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["250 requests/hour - The interval starts at the full hour (UTC based)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":3},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to have a Celonis team."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need an Application or API key for authentication before starting to initiate a Data Push Job."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-starting","__idx":4},"children":["Before starting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"determine-the-url-for-your-team","__idx":5},"children":["Determine the URL for your team"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["First you need to determine the URL for your team and cluster."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The base URL for the Celonis API is: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://<team>.<cluster>.celonis.cloud/data-ingestion/api"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To find the team and the cluster, please check the URL you use to access the Celonis EMS and retrieve the team and"," ","cluster from it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, the base URL for dev team in US-2 cluster would be:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll also need the Data Pool ID, for any further operations related to Data Push API. The Data Pool ID is displayed in the URL when you open a Data Pool in your Celonis team."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"install-a-rest-client","__idx":6},"children":["Install a REST client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Since the Data Push API is a REST API, you will need to have a way to interact with it. There are multiple ways to"," ","do this, but to make things simple, we will use Postman, which is a very popular and free REST client."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you already have a REST client, you can ignore this section."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Otherwise, go to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.postman.com/downloads/"},"children":["Postman Download page"]}," and download it for your Operating System. Once"," ","it's downloaded, install it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once installed, it should look like something like this:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/postman.fb7e39c0911cfc6226a27aeb1510092494b70f38ec367047218adb5a81f60521.4650e417.png","alt":"Screenshot showing a typical example of what the Postman login screen will look like when initially installed."},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start using it, create an account or click on \"Skip and go to the app\"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication","__idx":7},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each request to the API must be authenticated with a Celonis Application or API key. There are multiple ways of doing this:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"about-api-keys-and-application-keys","__idx":8},"children":["About API Keys and Application Keys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While it is possible to use API keys and Application keys with Celonis,"," ","it's important to note that they are not the industry standard. Both keys have an unlimited lifetime and cannot be “rotated”. This means that users need to delete and recreate them to achieve the equivalent of key rotation, which can be a cumbersome process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One issue (particularly relevant for API Keys) is that they give any"," ","application that uses them complete access to almost all the Celonis APIs."," ","There is no way to restrict their access to only certain resources."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"oauth-20-as-the-recommended-solution","__idx":9},"children":["OAuth 2.0 as the Recommended Solution"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["OAuth 2.0 is a well-established industry standard that makes it easier to"," ","integrate customer-managed applications with Celonis. OAuth uses scopes to manage access to resources, which means that the OAuth clients can only access APIs allowed by the scopes they are configured to use."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, we can have the scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["studio"]}," that gives access to Studio or the scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["audit.log:read"]}," that gives read-only access to audit logs. For an OAuth client to be able to access a certain resource (API), the client must have the OAuth scope and the Celonis permission to do so. This follows the security principle of least privilege so that an OAuth client gets only the required privilege to perform a certain task and not more."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"using-an-api-key","__idx":10},"children":["Using an API key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can find out how to create an API key by following"," ","our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.celonis.com/en/creating-api-keys"},"children":["User API Keys"]}," ","guide."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Celonis API uses Bearer Token Authentication for verifying consumer access. The credentials must be sent in an"," ","Authorization header in the HTTP request. Credentials sent in the URL or body of the request will be ignored."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To authenticate using Bearer Token Authentication:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the token in the EMS: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MDg5MGVkNDktNjMwZC00ODdiLTkyNGItMjNmMzMxNjRmM2IwOkhNUVRMUis4SGh6NHhBY21Vck9GaWdkem5rYzBrb3p0N056WUM0bGlqczMM"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include the string in the HTTP Authorization header formatted like this: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: **Bearer** MDg5MGVkNDktNjMwZC00ODdiLTkyNGItMjNmMzMxNjRmM2IwOkhNUVRMUis4SGh6NHhBY21Vck9GaWdkem5rYzBrb3p0N056WUM0bGlqczMM"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"using-an-application-api-key-user-independent-one","__idx":11},"children":["Using an Application API key (user independent one)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can find out how to create an Application by following"," ","our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.celonis.com/en/application-keys"},"children":["Application API Keys"]}," guide."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To authenticate using AppKey Authentication:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the Application in the EMS: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YjNiZDI4MWUtYzAyNS00NTJjLTk1MjAtZjE4ZGEzMjM5MzIzOlVTRzVhNis2djMzaUtBbFNoNVlFMDBsSFA5OEJ2MDA2c0REK3N2OWIzVHdm"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include the string in the HTTP Authorization header formatted like this: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: **AppKey** YjNiZDI4MWUtYzAyNS00NTJjLTk1MjAtZjE4ZGEzMjM5MzIzOlVTRzVhNis2djMzaUtBbFNoNVlFMDBsSFA5OEJ2MDA2c0REK3N2OWIzVHdm"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authorization","__idx":12},"children":["Authorization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The newly created Application Key is required to have necessary permission to be used for any Data Push API related operations."," ","There are two methods to provide these permissions:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Admin & Settings -> Permissions"]}," page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the permissions by editing the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data-Integration"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add permissions for a particular Data Pool, by clinking the three dots to the right of that Data Pool."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"consuming-the-data-push-api","__idx":13},"children":["Consuming the Data Push API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have completed the previous steps, you can start making requests to the API. This example will use Postman for that."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File > New..."]}," and select \"HTTP Request\". Once you do this, you should see something like this:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/empty-request.ac1ad5f8efa25bb14a1aa72e1369c8c4f98929781e1524b89a36dfaa541202a1.4650e417.png","alt":"Screenshot showing the Postman application when creating a new HTTP request."},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter the request URL next to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]}," button. For this URL use the one from the \"Determine the"," ","URL for your team\" section. In our example, the URL is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now you need to set your API or Application Key in order to authenticate our requests. To do this, click on the \"Headers\""," ","tab beneath the URL you just entered."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Key, enter \"Authorization\" and for Value, enter:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer <YOUR_KEY>"]}," if you have an API Key"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AppKey <YOUR_KEY>"]}," if you have an Application Key"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example uses an Application Key:"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/authorization-header.025de5556b4b5f2bf1f34e7a684b8a6a5c2b518185e057ad0b2e90cb6d2cea3d.4650e417.png","alt":"Postman interface displaying authorization header setup with Bearer token format in the Headers tab."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-a-new-data-push-job","__idx":14},"children":["Creating a new Data Push Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api/v1/data-push/bea4fb85-5d27-4336-b4db-b83207e8a03a/jobs/"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A POST request should be made to create a Data Push Job, which will create a new Data Push Job and provide a unique ID for this newly created job as a result."," ","This ID should be used for the remaining operations performed with regards to this particular Data Push Job."," ","The request body must provide values for the mandatory fields."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["type:"]}," DELTA/REPLACE"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fileType:"]}," PARQUET/CSV"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["targetTable:"]}," Desired TableName in DataLake"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["dataPoolId:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dataPoolId"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/create-data-push-job.112b522679d413bfb44bce7b00142e12bb0664a9baa6c1ce590d77547f676d6c.4650e417.png","alt":"Screenshot showing an example of the POST request used to create a DataPushJob request in Postman."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"upserting-chunks-to-a-data-push-job","__idx":15},"children":["Upserting chunks to a Data Push Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the Data Push Job has been created, use its ID to upsert chunks/files. Multiple files can be uploaded in the context of a single Data Push job."," ","We support PARQUET and CSV file as chunks to be uploaded."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api/v1/data-push/bea4fb85-5d27-4336-b4db-b83207e8a03a/jobs/00e7706a-e2f7-49be-a7be-6098628774d9/chunks/upserted"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/chunk-upsert.7f578fa79f7cedfb553f7f5ca4e3b15db572d9a85f6b185ca5ffbd3d0b411dd2.4650e417.png","alt":"Screenshot showing files being added to a Data Push Job to be uploaded."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"executing-a-data-push-job","__idx":16},"children":["Executing a Data Push Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The POST request to execute the Data Push job will insert the data provided in the chunks of the Data Push job one by one."," ","After the successful execution of a Data Push job, you will be able to see new records in the table."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api/v1/data-push/bea4fb85-5d27-4336-b4db-b83207e8a03a/jobs/00e7706a-e2f7-49be-a7be-6098628774d9"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/execute-data-push-job.e20eb75c61fce597743f4be2faf7bf8fd922ba69c250e09c044e9638d8948599.4650e417.png","alt":"Screenshot showing a request to execute a Data Push job in Postman."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getting-a-data-push-job","__idx":17},"children":["Getting a Data Push Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GET request (with URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api/v1/data-push/bea4fb85-5d27-4336-b4db-b83207e8a03a/jobs/00e7706a-e2f7-49be-a7be-6098628774d9"]},")"," ","can be used to get the details of a particular Data Push job."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/get-data-push-job.5525768a5163805d6073b97744c2c11260c9f59768432cd2e74a470f547bae57.4650e417.png","alt":"Screenshot showing a request to get the details of a Data Push job in Postman."},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cancel-a-data-push-job","__idx":18},"children":["Cancel a Data Push Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Data Push job can be canceled by a POST request (with URL GET request, with URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.us-2.celonis.cloud/data-ingestion/api/v1/data-push/bea4fb85-5d27-4336-b4db-b83207e8a03a/jobs/00e7706a-e2f7-49be-a7be-6098628774d9/cancel"]},"),"," ","if the Data Push job is not in a DONE/CANCELED/ERROR status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/data-push-us-2.postman_collection.0e1d6398b108ac42c9cedb3a13d5e87ba55255a9bc6ba827b8e6730d401f8ea9.52083f02.json"},"children":["Postman Collection for reference."]}]}]},"headings":[{"value":"Getting Started","id":"getting-started","depth":1},{"value":"How it works","id":"how-it-works","depth":2},{"value":"API Limits:","id":"api-limits","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Before starting","id":"before-starting","depth":2},{"value":"Determine the URL for your team","id":"determine-the-url-for-your-team","depth":3},{"value":"Install a REST client","id":"install-a-rest-client","depth":3},{"value":"Authentication","id":"authentication","depth":3},{"value":"About API Keys and Application Keys","id":"about-api-keys-and-application-keys","depth":4},{"value":"OAuth 2.0 as the Recommended Solution","id":"oauth-20-as-the-recommended-solution","depth":5},{"value":"Using an API key","id":"using-an-api-key","depth":4},{"value":"Using an Application API key (user independent one)","id":"using-an-application-api-key-user-independent-one","depth":4},{"value":"Authorization","id":"authorization","depth":3},{"value":"Consuming the Data Push API","id":"consuming-the-data-push-api","depth":2},{"value":"Creating a new Data Push Job","id":"creating-a-new-data-push-job","depth":3},{"value":"Upserting chunks to a Data Push Job","id":"upserting-chunks-to-a-data-push-job","depth":3},{"value":"Executing a Data Push Job","id":"executing-a-data-push-job","depth":3},{"value":"Getting a Data Push Job","id":"getting-a-data-push-job","depth":3},{"value":"Cancel a Data Push Job","id":"cancel-a-data-push-job","depth":3}],"frontmatter":{"seo":{"title":"Getting Started"}},"lastModified":"2026-06-08T21:02:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/data-ingestion-api/getting-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}