REST API
Version 25.3.9396
Version 25.3.9396
REST API
CData Sync provides a REST API that complies with the OData 4.0 standard. With this API, you can use RESTful API calls to perform the same tasks that you do in the Sync administration console. For example, you can use the API to query configured connections, jobs, and job history. You can start or cancel jobs, as well.
The REST API is composed of three separate APIs, each of which corresponds to a major component of the Sync application: job management, connection management, and user management. The tables below outline the endpoints that are available for each of these components, along with supported methods and descriptions of their purposes.
Job Management API
| Endpoint | Supported Methods | Description |
|---|---|---|
| Jobs | GET, POST, PUT, DELETE | Retrieves or updates the configuration for existing job or creates a new job. |
| Transformations | GET, POST, PUT, DELETE | Retrieves or updates the configuration for existing transformations or creates a new transformation. |
| Tasks | GET, POST, PUT, DELETE | Retrieves or updates the configuration for existing tasks of a job or adds a new task to a job. |
| GetJobStatus | POST | Retrieves the status of all jobs or the status of each query within a specified job. |
| ExecuteJob | POST | Starts the specified job. |
| ExecuteQuery | POST | Executes a subset of queries within a job. You must specify both the job and the query. |
| CancelJob | POST | Cancels a currently running job. |
| History | GET | Retrieves the history of previous job runs. |
| GetJobLog | POST | Retrieves logs from a previous job run or job runs. |
Connection Management API
| Endpoint | Supported Methods | Description |
|---|---|---|
| Connections | GET, POST, PUT, DELETE | Retrieves or updates the configuration for existing connections or adds a new connection to the application. |
| TestConnection | POST | Tests a previously created connection. |
| GetConnectionTables | POST | Retrieves a list of tables for a connection. |
| GetConnectionTableColumns | POST | Retrieves a list of columns for a table. |
User Management API
| Endpoint | Supported Methods | Description |
|---|---|---|
| Users | GET, POST, PUT | Creates, retrieves, or updates Sync users. |
| CreateUsers | POST | Creates multiple Sync users. |