Update a calendar slot
PATCH/v2/experiences/{experienceId}/options/{optionId}/slots/{slotId}
Requires your API key in the X-API-Key header.
Updates the organizer-managed settings of a single availability slot. Requires authentication and is restricted to the experience's organizer. Returns 400 on externally-sourced experiences and on options synced from an external provider (externalId set) — external capacity is owned by the sync.
At least one field must be present: capacityOverride (a per-slot capacity cap; null clears it back to the option's slotCapacity; must be a non-negative integer and cannot be set below the slot's current live-booked participant quantity) or isBookable (opens or closes sales for the slot without cancelling existing bookings).
Responds with the slot re-serialized in the calendar shape, so availableQuantity and availabilityStatus reflect the change.
curl -X PATCH "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/options/3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6/slots/6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d" \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"capacityOverride": 3
}'Path parameters
experienceIdstring (uuid)requiredUUID of the parent experience.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
optionIdstring (uuid)requiredUUID of the option (must belong to the experience in the path).
- Example:
3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
slotIdstring (uuid)requiredUUID of the availability slot (must belong to the option in the path).
- Example:
6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d
Request bodyapplication/json, required
capacityOverrideintegernullablePer-slot capacity cap.
nullclears the override. Must be a non-negative integer not below the slot's current live-booked quantity.- Limits:
- minimum 0
- Example:
3
isBookablebooleanOpen (
true) or close (false) sales for the slot.- Example:
false
Example: Cap the slot at 3 seats
{
"capacityOverride": 3
}Example: Clear the override
{
"capacityOverride": null
}Example: Close sales for the slot
{
"isBookable": false
}Responses
200object
The updated slot in calendar shape.
idstring (uuid)Slot id.
- Example:
6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d
startDatestring (date)Slot date, local to the experience.
- Example:
2026-07-14
startTimestringnullableSlot start time (
HH:MM:SSlocal).nullfor DATE_ONLY options.- Example:
09:00:00
localTimestringCombined local start as an ISO string —
YYYY-MM-DDTHH:MM:SS, or justYYYY-MM-DDwhen the slot has no start time.- Example:
2026-07-14T09:00:00
isBookablebooleanWhether the slot accepts new bookings. False when the organizer closed sales or slot regeneration orphaned it while it still had bookings.
- Example:
true
externalCapacityintegernullableCapacity last reported by the external provider. Authoritative only on genuinely external options; a stale value on native Turneo options is ignored for status computation.
capacityOverrideintegernullableOrganizer-set per-slot capacity cap.
nullmeans the option'sslotCapacityapplies.- Example:
8
bookingsQuantityintegerCapacity-relevant participants currently booked on the slot (live bookings only, including guest basket holds; capacity-exempt types such as infants excluded).
- Example:
2
onHoldQuantityintegerSubset of
bookingsQuantitysitting in guest baskets (ON_HOLD). Still consumes capacity until the guest pays or the hold lapses. Can lag by up to the hold-expiry sweep interval: a lapsed hold still reads as held until the expiry task runs. On external-provider slots (Bokun/Regiondo/Rezdy)availableQuantityis the provider's own count and is not reduced by local bookings, so the three quantities do not reconcile there.- Example:
1
availableQuantityintegernullableRemaining bookable capacity (effective capacity minus
bookingsQuantity).nullwhen the option has no capacity source (e.g. purely resource-driven).- Example:
6
availabilityStatusstringComputed operational status: SELLING (bookable, capacity left), SOLD_OUT (no capacity left), BLOCKED (overlapped by an option block), CLOSED (sales stopped on this slot,
isBookable: false, bookings untouched), CANCELLED (soft-deleted, its bookings cancelled).- Allowed values:
SELLINGSOLD_OUTBLOCKEDCLOSEDCANCELLED- Example:
SELLING
discountobjectnullableDiscount a booking made right now would receive, or null.
Child fields
percentagenumberDiscount percentage.
- Example:
10
typestringDiscount source — the option's early-bird rule or a scheduled availability discount.
- Allowed values:
EARLY_BIRDAVAILABILITY- Example:
AVAILABILITY
{
"id": "6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d",
"startDate": "2026-07-14",
"startTime": "09:00:00",
"localTime": "2026-07-14T09:00:00",
"isBookable": true,
"externalCapacity": null,
"capacityOverride": 8,
"bookingsQuantity": 2,
"onHoldQuantity": 1,
"availableQuantity": 6,
"availabilityStatus": "SELLING",
"discount": {
"percentage": 10,
"type": "AVAILABILITY"
}
}204
Edge case — the update was persisted but the slot no longer appears in the recomputed calendar for its date; no body is returned.
Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}