Slotflow APISchedule Overrides

Create a schedule override

Create a schedule override for a human. Overrides modify availability beyond the base schedule. **Block overrides** remove availability: - All-day blocks for vacations or holidays - Time-specific blocks for recurring meetings or focus time **Open overrides** add extra availability: - Weekend or evening hours for overtime - Special event availability outside normal schedule Overrides support date ranges (`start_date` to `end_date`) and recurring patterns via the `recurrence` field.

Authentication

AuthorizationBearer
API key authentication. Pass your key as a Bearer token: ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx ``` Get your API key from the [Slotflow Dashboard](https://app.slotflow.dev).

Path parameters

humanIdstringRequiredformat: "uuid"
The ID of the human

Request

This endpoint expects an object.
typeenumRequired

block to remove availability, open to add extra availability

Allowed values:
titlestringRequired
Descriptive label for this override
all_daybooleanRequired

Set to true for full-day overrides. When false, start_time and end_time are required.

start_datedateRequired

Start date (YYYY-MM-DD)

end_datedateOptional

End date for multi-day overrides (YYYY-MM-DD). Optional.

start_timestringOptionalformat: "^\d{2}:\d{2}$"

Required when all_day is false. HH:MM format in human’s timezone.

end_timestringOptionalformat: "^\d{2}:\d{2}$"

Required when all_day is false. HH:MM format in human’s timezone.

recurrenceobjectOptional

Defines a recurring pattern for schedule overrides. Null for one-time overrides.

Response

Override created
idstring or nullformat: "uuid"
human_idstring or nullformat: "uuid"
typeenum or null

block removes availability, open adds extra availability

Allowed values:
titlestring or null

Descriptive label (e.g. “Holiday break”, “Saturday overtime”)

all_dayboolean or null
Whether this override applies to the entire day
start_datedate or null

Start date (YYYY-MM-DD)

end_datedate or null

End date for multi-day overrides (YYYY-MM-DD). Null for single-day.

start_timestring or nullformat: "^\d{2}:\d{2}$"

Start time in HH:MM format. Null when all_day is true.

end_timestring or nullformat: "^\d{2}:\d{2}$"

End time in HH:MM format. Null when all_day is true.

recurrenceobject or null

Defines a recurring pattern for schedule overrides. Null for one-time overrides.

created_atdatetime or null

Errors