Skip to navigation
API ReferenceSlotflow APIAvailability

Set availability rules

Set or replace availability rules for a human. This is a full replace — send all fields every time.

Availability rules define the human’s base weekly schedule:

  • working_days — which days of the week (1=Monday through 7=Sunday)
  • work_start / work_end — working hours in HH:MM format (in the human’s timezone)
  • meeting_durations — allowed meeting lengths in minutes

For one-off changes (vacations, overtime, recurring meetings), use Schedule Overrides instead.

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.

Path parameters

humanIdstringRequiredformat: "uuid"
The ID of the human

Request

This endpoint expects an object.
working_dayslist of integersRequired

Days of the week. 1=Monday through 7=Sunday.

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

Start of working hours in HH:MM format (in human’s timezone)

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

End of working hours in HH:MM format (in human’s timezone)

meeting_durationslist of integersRequired
Allowed meeting durations in minutes

Response

Human with updated availability rules
activeboolean
Whether the human is active and bookable
created_atdatetime
ISO 8601 creation timestamp
idstringformat: "uuid"
Unique identifier for the human
namestring
Full name of the human
timezonestring

IANA timezone identifier (e.g. “America/New_York”)

availability_rulesobjectOptional
The human's base weekly schedule. Null if not yet configured.
emailstring or nullOptional

Email address (optional)

rolestring or nullOptional

Role or title (e.g. “sales_rep”, “interviewer”)

Errors

404
Not Found Error
422
Unprocessable Entity Error