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.

Requestbash
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)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • optionIdstring (uuid)required

    UUID of the option (must belong to the experience in the path).

    Example:
    3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
  • slotIdstring (uuid)required

    UUID of the availability slot (must belong to the option in the path).

    Example:
    6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d

Request bodyapplication/json, required

  • capacityOverrideintegernullable

    Per-slot capacity cap. null clears the override. Must be a non-negative integer not below the slot's current live-booked quantity.

    Limits:
    minimum 0
    Example:
    3
  • isBookableboolean

    Open (true) or close (false) sales for the slot.

    Example:
    false
Example: Cap the slot at 3 seats
Cap the slot at 3 seatsjson
{
  "capacityOverride": 3
}
Example: Clear the override
Clear the overridejson
{
  "capacityOverride": null
}
Example: Close sales for the slot
Close sales for the slotjson
{
  "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
  • startTimestringnullable

    Slot start time (HH:MM:SS local). null for DATE_ONLY options.

    Example:
    09:00:00
  • localTimestring

    Combined local start as an ISO string — YYYY-MM-DDTHH:MM:SS, or just YYYY-MM-DD when the slot has no start time.

    Example:
    2026-07-14T09:00:00
  • isBookableboolean

    Whether the slot accepts new bookings. False when the organizer closed sales or slot regeneration orphaned it while it still had bookings.

    Example:
    true
  • externalCapacityintegernullable

    Capacity last reported by the external provider. Authoritative only on genuinely external options; a stale value on native Turneo options is ignored for status computation.

  • capacityOverrideintegernullable

    Organizer-set per-slot capacity cap. null means the option's slotCapacity applies.

    Example:
    8
  • bookingsQuantityinteger

    Capacity-relevant participants currently booked on the slot (live bookings only, including guest basket holds; capacity-exempt types such as infants excluded).

    Example:
    2
  • onHoldQuantityinteger

    Subset of bookingsQuantity sitting 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) availableQuantity is the provider's own count and is not reduced by local bookings, so the three quantities do not reconcile there.

    Example:
    1
  • availableQuantityintegernullable

    Remaining bookable capacity (effective capacity minus bookingsQuantity). null when the option has no capacity source (e.g. purely resource-driven).

    Example:
    6
  • availabilityStatusstring

    Computed 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
  • discountobjectnullable

    Discount a booking made right now would receive, or null.

    Child fields
    • percentagenumber

      Discount percentage.

      Example:
      10
    • typestring

      Discount source — the option's early-bird rule or a scheduled availability discount.

      Allowed values:
      EARLY_BIRDAVAILABILITY
      Example:
      AVAILABILITY
Response 200json
{
  "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[].field and errors[].code.

401

Missing or invalid X-API-Key header.

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
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}