Skip to main content
POST

Authorizations

Authorization
string
header
required

Include the access token in the Authorization header using the Bearer scheme.

Query Parameters

language
enum<string>

Output language. Defaults to en. Product-supported language for generated Reasoning Engine output.

Available options:
en,
de,
fr,
es,
it,
nl,
sv,
nb,
lv

Body

application/json

Roster data to analyze.

context
object
required

High-level information about the job that is being started.

employees
object[]
required

List of employees to be used in this roster.

demands
object[]
required

List of demands used in this roster.

shifts
object[]

List of shifts that employees can be assigned to.

timeSlots
object[]

List of time slots for which demand can be specified (only if using TIME_DEMAND)

rules
object

Rules that should be active. Used to specify all sorts of preferences and restrictions.

extensions
object

Extensions that can be helpful in more advanced rostering scenarios.

statusOptions
object

Optional configuration for live status updates during the run, including metrics to track and return from the status endpoint.

Response

Finding messages and an optional summary.

findings
object[]
required

Observations about the roster.

Maximum array length: 30
summary
object

Summary of the analysis.