Sign in
PractitionerRotas

Create a practitioner rota

Creates a new PractitionerRota for the practitioner identified by practitioner_id in the request body. Equivalent to calling the nested POST /shop/practitioners/{practitionerId}/rotas endpoint but doesn't require the practitioner ID in the URL.

post/shop/practitioner-rotas

Request body

practitioner_idstring object-id required

Practitioner the new rota applies to. The caller must have SCHEDULE_MANAGE (or equivalent) on every site the practitioner works at — otherwise the request is rejected with 403.

start_datestring date nullable

The date from which this rota is active (YYYY-MM-DD).

end_datestring date nullable

The date on which this rota ends. Omit or pass null for an open-ended rota.

scheduling_week_intervalinteger required

The number of weeks in the rolling schedule cycle.

Example request

{
  "practitioner_id": "5dcb47800000000000000010",
  "scheduling_week_interval": 2,
  "availability_rules": [
    {
      "week_num": 1,
      "weekday": "monday",
      "time_from": "09:00",
      "time_to": "17:00",
      "offerings": [
        {
          "offering_name": "Twilight massage",
          "offering_type": "appointment"
        }
      ]
    }
  ]
}

Response

A single PractitionerRota object.

Example response

{
  "data": {
    "scheduling_week_interval": 2,
    "availability_rules": [
      {
        "week_num": 1,
        "weekday": "monday",
        "time_from": "09:00",
        "time_to": "17:00",
        "offerings": [
          {
            "offering_name": "Twilight massage",
            "offering_type": "appointment"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.