Starting dates and places

Starting dates and places are metadata related for Trainings. They represent the time and place that a training takes place. This can be physical, but also online.

At this moment it is not possible to create trainings using the API. However, it is possible to create and update "starting_dateplaces" for existing trainings via the endpoint summarized on this page.

Note: be aware that if your institute has a running XML import where StartingDatePlaces are imported, this probably overrule any changes done via this endpoint. Contact datasupport@springest.com to discuss the possibilities.

Method	Description
POST /trainings/:id/starting_dateplaces.xml	Create a starting_dateplace for an existing training
PATCH /starting_dateplaces/:id.xml	Updating a starting_dateplace

Available methods

Note: next to .xml, .json is also supported.

Create a starting_dateplace for an existing training

Request: POST /trainings/:id/starting_dateplaces.xml?api_key=YOURAPIKEY

With this endpoint you can create a starting_dateplace for an existing training. If you do not know the id of your existing training, you can obtain that via the Trainings endpoint, by querying on the training's name with the query parameter.

Update a starting_dateplace

Request: PATCH /starting_dateplaces/:id.xml?api_key=YOURAPIKEY

Validations: before we create a starting_dateplace there are some validations/requirements that have to be fulfilled showing correct data to our users.

• Startdate > now()
• Enddate >= Startdate
• Location contains an existing place (except when online=true) 
• Maximum_number_of_seats > Minimum_number_of_seats
• Maximum_number_of_seats > Available_number_of_seats