Skip to main content
PATCH
Update an availability schedule

Uso

Usalo dentro de Bookable Payments para modelar inventario reservado, calcular disponibilidad, crear holds, convertirlos en checkout y confirmar bookings.

Antes de llamar

Patron recomendado

  • Ejecuta este endpoint desde backend o job seguro, nunca desde frontend con API keys.
  • Manda Idempotency-Key cuando el endpoint cree, convierta, reprograme, cancele, capture o reembolse estado.
  • Confirma inventario final con booking.confirmed o una lectura de booking, no solo con una URL de retorno.
  • Consulta el bloque OpenAPI de esta pagina para el shape exacto de parametros, body y respuestas.

Ejemplo minimo

terminal

Errores a manejar

  • 400 indica payload, parametros o estado invalido.
  • 401 o 403 indican API key, ambiente o scopes incorrectos.
  • 409 suele indicar conflicto de estado, duplicado o idempotencia incompatible.
  • 404 significa que el recurso no existe para ese tenant o ambiente.
  • 429 y 5xx se pueden reintentar con backoff; en writes conserva la misma idempotency key.

Contrato OpenAPI

El playground, parametros, body y respuestas de abajo salen de /openapi.json. Si el contrato cambia, actualiza la spec y regenera esta pagina.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required
Required string length: 8 - 255

Path Parameters

id
string<uuid>
required

Body

application/json
active
boolean
metadata
object
name
string
Minimum string length: 1
time_zone
string

Response

200 - application/json

Availability schedule updated

active
boolean
id
string<uuid>
metadata
object
name
string
object
any
overrides
object[]
rules
object[]
timeZone
string
updatedAt
string<date-time>
Last modified on June 21, 2026