Added
OnSched 3.13.0 - external unavailability ingest and safer appointment lists
about 10 hours ago by ReadMe GitHub Action
API
GET /v3/unavailability?syncExternal=true: Ingest connected Google or Outlook busy events for resolved resources before returning calendar rows. Defaultfalse/omitkeeps today's list behavior, including stored external blocks that already match scope filters. UnlikeGET /v3/availability, this flag does not hide stored external busy whenfalse.- Deprecated alias:
GET /v3/unavailability/calendaraccepts the same parameter.
Appointment list safeguards
- Bounded offset pagination:
GET /v3/appointmentsrejects requests where(page - 1) * limitexceeds10,000. Use date and entity filters to partition larger appointment histories. - Company rate budget: By default, appointment lists allow a burst of 10 requests, then refill at one request per second. Rate-limit rejections return
429withRetry-After. - Fair concurrent request protection: Each API instance caps active appointment-list work globally and per Company. A small bounded queue absorbs brief overlap without increasing active database work; full or expired queues return
429withRetry-After. - Safe page walks: Request pages sequentially, stop on empty
dataor whenpage * limit >= count, and retry the same page after a429delay.
