Reemplazar el horario semanal de una persona | Documentación API de Recurrente

curl -X PUT https://app.recurrente.com/api/staff_members/staff_member_id/schedule \
     -H "X-SECRET-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "blocks": [
    {
      "weekday": 1,
      "opens_at": "08:30",
      "closes_at": "12:30"
    },
    {
      "weekday": 1,
      "opens_at": "13:30",
      "closes_at": "17:30"
    },
    {
      "weekday": 3,
      "opens_at": "10:00",
      "closes_at": "16:00"
    }
  ]
}'

{
  "owner_id": "stf_9876543210",
  "uses_business_hours": false,
  "time_zone": "America/Guatemala",
  "blocks": [
    {
      "weekday": 1,
      "opens_at": "08:30",
      "closes_at": "12:30"
    },
    {
      "weekday": 1,
      "opens_at": "13:30",
      "closes_at": "17:30"
    },
    {
      "weekday": 3,
      "opens_at": "10:00",
      "closes_at": "16:00"
    }
  ]
}

Reemplaza su semana con blocks: uno por tramo, dos para un día con pausa. Un día sin tramos queda cerrado. Con uses_business_hours: true deja su horario propio y vuelve al del negocio. Si un tramo no se lee como horario, no cambia nada y responde 422 con code: invalid_schedule.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

staff_member_idstringRequired

Request

This endpoint expects an object.

uses_business_hoursbooleanOptional

blockslist of objectsOptional

Response

El horario nuevo

owner_idstringOptional

La cuenta (ac_) o la persona del equipo (stf_).

uses_business_hoursbooleanOptional

Una persona sin horario propio trabaja el del negocio; blocks son entonces los del negocio.

time_zonestringOptional

blockslist of objectsOptional

Errors

422

Unprocessable Entity Error