Schedules

Read and set a configuration's run schedule.

Retrieving a schedule

get

This functionality is in preview mode - some of the features may not be fully operational yet.

Retrieves the cron schedule for a configuration.

Required scopes

This endpoint requires the following scopes:

• : Needed to trigger, schedule, monitor, and cancel import runs and to read configurations, streams, schedules, runs, and imported data.

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

The tenant you want to access.

Example: mytenant

configIdstring · uuidRequired

The configuration identifier.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

Responses

200

The request was successful. The schedule is returned.

application/json

A cron schedule for a configuration.

idstring · uuidOptional

The schedule identifier.

Example: a3bb189e-8bf9-3888-9912-ace4e6543002

configIdstring · uuidOptional

The scheduled configuration.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

cronstringRequired

A Spring cron expression with six fields.

Example: 0 0 2 * * *

timezonestringOptional

The IANA time zone the cron is evaluated in.

Example: Europe/Berlin

enabledbooleanOptional

Whether the schedule is active.

Example: true

nextFireAtstring · date-timeOptional

The next fire time.

Example: 2026-07-28T00:00:00.000Z

204

No schedule is configured for the configuration.

401

Given request is unauthorized - the authorization token is invalid or has expired. Details will be provided in the response payload.

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

500

Internal Service Error occurred.

application/json

get/importtool/{tenant}/configs/{configId}/schedule

HTTPcURLJavaScriptPython

GET /importtool/{tenant}/configs/{configId}/schedule HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "configId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "cron": "0 0 2 * * *",
  "timezone": "Europe/Berlin",
  "enabled": true,
  "nextFireAt": "2026-07-28T00:00:00.000Z"
}

Scheduling an import job

put

This functionality is in preview mode - some of the features may not be fully operational yet.

Creates or updates the cron schedule (cron expression, time zone, and enabled flag) that runs a configuration automatically.

Required scopes

This endpoint requires the following scopes:

• : Needed to trigger, schedule, monitor, and cancel import runs and to read configurations, streams, schedules, runs, and imported data.

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

The tenant you want to access.

Example: mytenant

configIdstring · uuidRequired

The configuration identifier.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

Body

application/json

A cron schedule for a configuration.

idstring · uuidOptional

The schedule identifier.

Example: a3bb189e-8bf9-3888-9912-ace4e6543002

configIdstring · uuidOptional

The scheduled configuration.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

cronstringRequired

A Spring cron expression with six fields.

Example: 0 0 2 * * *

timezonestringOptional

The IANA time zone the cron is evaluated in.

Example: Europe/Berlin

enabledbooleanOptional

Whether the schedule is active.

Example: true

nextFireAtstring · date-timeOptional

The next fire time.

Example: 2026-07-28T00:00:00.000Z

Responses

200

The request was successful. The schedule has been saved.

application/json

A cron schedule for a configuration.

idstring · uuidOptional

The schedule identifier.

Example: a3bb189e-8bf9-3888-9912-ace4e6543002

configIdstring · uuidOptional

The scheduled configuration.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

cronstringRequired

A Spring cron expression with six fields.

Example: 0 0 2 * * *

timezonestringOptional

The IANA time zone the cron is evaluated in.

Example: Europe/Berlin

enabledbooleanOptional

Whether the schedule is active.

Example: true

nextFireAtstring · date-timeOptional

The next fire time.

Example: 2026-07-28T00:00:00.000Z

401

Given request is unauthorized - the authorization token is invalid or has expired. Details will be provided in the response payload.

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

500

Internal Service Error occurred.

application/json

put/importtool/{tenant}/configs/{configId}/schedule

HTTPcURLJavaScriptPython

PUT /importtool/{tenant}/configs/{configId}/schedule HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "cron": "0 0 2 * * *",
  "timezone": "Europe/Berlin",
  "enabled": true
}

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "configId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "cron": "0 0 2 * * *",
  "timezone": "Europe/Berlin",
  "enabled": true,
  "nextFireAt": "2026-07-28T00:00:00.000Z"
}