Hold a timeslot

POST

/timeslots/hold

Timeslots

Last modified:2026-06-03 19:01:51

Maintainer:Not configured

Reserves a timeslot for 30 minutes. Returns a hold_hash which must be passed to POST /bookings to complete the booking.

Limits:

Only one active hold per client is permitted at a time. If you already have an active hold, a 409 Conflict is returned with the existing hold's details.

The slot must appear in the GET /timeslots response (i.e. a trainer must be available).

Release a mistaken hold with DELETE /timeslots/hold/{holdHash}.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Slot held successfully.

Bodyapplication/json

🟠409

🟠401Unauthorized

🟠422ValidationError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/timeslots/hold' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "course_id": 1,
    "date": "2026-06-10",
    "time": "09:00"
}'

Response Example

201 - Success

{
    "hold_hash": "Xy7kRtQmNpLsWvBzJcFdEaHgUiOeYtAn",
    "expires_at": "2026-06-03T18:30:00+00:00",
    "expires_in_seconds": 1800,
    "slot": {
        "date": "2026-06-10",
        "time": "09:00",
        "course": {
            "id": 1,
            "name": "BLS — Annual Renewal"
        }
    }
}

Modified at 2026-06-03 19:01:51

List available timeslots

Release a slot hold