Overbooking policies

What you configure

overbooking.mode

Choose block, warn, or allow for the resource profile.

maxUtilizationPercent

Set the policy's utilization ceiling.

reserveUnits

Account for capacity that should remain reserved.

Integration code example

1. Define capacity units and choose the policy for each relevant resource.
2. Evaluate proposed bookings with current events and planning profiles.
3. Surface warnings and reasons, and decide whether a permitted booking should be committed.

Copy this TypeScript into your application, not the browser console. Replace YOUR_WTS_LICENSE_KEY with an entitlement issued for your deployment origin. A WTS license is not a Google, Microsoft or CalDAV credential. These examples are documentation only and never execute on this page.

npm install @wts-calendar/core

import { verifyCalendarLicense } from '@wts-calendar/core';
import { AdvancedResourcePlanner } from '@wts-calendar/core/advanced-resource-planning';

const license = await verifyCalendarLicense('YOUR_WTS_LICENSE_KEY');
const planner = new AdvancedResourcePlanner({
  license,
  timeZone: 'UTC',
  resources: [
    { id: 'design', title: 'Design studio', capacity: 2 },
    { id: 'engineering', title: 'Engineering', capacity: 4 },
  ],
  events: [
    {
      id: 'review',
      title: 'Design review',
      resourceId: 'design',
      start: '2026-09-07T09:00:00Z',
      end: '2026-09-07T10:30:00Z',
    },
  ],
  profiles: [
    { resourceId: 'design', overbooking: { mode: 'warn', maxUtilizationPercent: 100 } },
  ],
});

export const decision = planner.evaluateBooking({
  resourceId: 'design',
  start: '2026-09-07T09:30:00Z',
  end: '2026-09-07T10:00:00Z',
  units: 2,
});
console.log(decision.allowed, decision.projectedUtilizationPercent, decision.issues);

Application responsibilities

The engine returns data, not a built-in chart. Render results in your application and call planner.setData() after resources, events or profiles change.

Use block to reject over-capacity bookings, warn to require your application to surface warnings, or allow when your policy permits them. Evaluation alone does not create a booking.

Behavior and lifecycle

• Evaluation retains issues even when the chosen mode allows the proposal.
• Policy-adjusted capacity is also available to utilization analysis.