Availability · StartupBuilder

Properties

Property	Type	Required	Description
`worker`	Worker	required	Who is booked: a Human, or an Agent that takes calls.
`hours`	`json`	required	Open hours by weekday, in its time zone.
`timezone`	`string`	required	An IANA time zone.
`calendars`	`string[]`		Connected calendars whose busy times it subtracts.
`buffer`	`integer`		Minutes kept free before and after each Meeting.
`notice`	`integer`		The fewest hours ahead a Meeting can be booked.

Object

JSON

{
  "$id": "https://api.sb/leaseline.app/availabilities/availability_8Zj0a7vvRl",
  "$type": "Availability",
  "worker": "worker_whZFpOKWIV",
  "hours": {
    "mon": [
      "09:00-12:00"
    ],
    "thu": [
      "13:00-17:00"
    ]
  },
  "timezone": "America/Chicago",
  "calendars": [
    "Example calendars"
  ],
  "buffer": 10,
  "notice": 12
}

Relationships

An Availability has many Meeting Types: each Meeting Type books into one Availability, and an Availability serves many Meeting Types. meetingTypes, inverse booksInto.

Verbs

createCreates an Availability.
POST /{namespace}/availabilitiesdoAvailability.created
getReturns one Availability by id.
GET /{namespace}/availabilities/{id}readNo Event
listReturns Availabilities, newest first, one page at a time.
GET /{namespace}/availabilitiesreadNo Event
updateChanges the given properties of an Availability.
PATCH /{namespace}/availabilities/{id}doAvailability.updated
deleteDeletes an Availability: a soft delete that keeps its history, undone by `Thing.restore`.
DELETE /{namespace}/availabilities/{id}doAvailability.deleted
setSet records the weekly hours a Worker can be booked in and the calendars whose busy times it subtracts.
POST /{namespace}/availabilities/setdoAvailability.set

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operation	`owner`	`admin`	`member`	`viewer`
`Availability.create`	Yes	Yes	Yes	No
`Availability.get`	Yes	Yes	Yes	Yes
`Availability.list`	Yes	Yes	Yes	Yes
`Availability.update`	Yes	Yes	Yes	No
`Availability.delete`	Yes	Yes	Yes	No
`Availability.set`	Yes	Yes	Yes	No

Call it

In code: API · SDK · CLI · MCP.

Text

Set the latest availability with a worker.

Works with

With	Links
Roles	Customer Lead
Systems	Scheduling
Guides	Give me a booking link

Dana Okafor keeps two mornings a week open for calls, in America/Chicago. Her Availability subtracts whatever her connected calendar already holds and keeps 10 minutes free around each Meeting. It refuses a booking less than 12 hours ahead.

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

RelationshipsCopy Anchor Link

VerbsCopy Anchor Link

PermissionsCopy Anchor Link

Call itCopy Anchor Link

Works withCopy Anchor Link

ExampleCopy Anchor Link