Update an availability

curl --request PATCH \
  --url https://{your-workspace}.neetocal.com/api/external/v1/availabilities/{availability_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "periods": [
    {
      "wday": "monday",
      "start_time": "09:00 AM",
      "end_time": "05:00 PM"
    },
    {
      "wday": "tuesday",
      "start_time": "11:00 AM",
      "end_time": "04:00 PM"
    }
  ],
  "overrides": [
    {
      "date": "2025-03-07",
      "periods": [
        {
          "wday": "friday",
          "start_time": "11:00 AM",
          "end_time": "04:00 PM"
        }
      ]
    }
  ],
  "time_zone": "America/New_York"
}
'

{
  "message": "<string>",
  "availability": {
    "id": "01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a",
    "sid": "2nq7q5c",
    "name": "Availability for custom user",
    "default": false,
    "after_buffer_time": 0,
    "before_buffer_time": 0,
    "periods": [
      {
        "id": "21c812a7-3859-4f01-b214-850e6f11caad",
        "wday": "monday",
        "start_time": "09:00 AM",
        "end_time": "05:00 PM"
      }
    ],
    "overrides": [
      {
        "date": "2025-03-07",
        "periods": [
          {
            "wday": "friday",
            "start_time": "10:00 AM",
            "end_time": "03:00 PM"
          }
        ]
      }
    ],
    "user": {
      "id": "b6d02dfa-8ef6-453d-b9f7-67a6f20bcaa6",
      "name": "Oliver Smith",
      "email": "[email protected]"
    }
  }
}

PATCH

availabilities

{availability_id}

Update an availability

curl --request PATCH \
  --url https://{your-workspace}.neetocal.com/api/external/v1/availabilities/{availability_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "periods": [
    {
      "wday": "monday",
      "start_time": "09:00 AM",
      "end_time": "05:00 PM"
    },
    {
      "wday": "tuesday",
      "start_time": "11:00 AM",
      "end_time": "04:00 PM"
    }
  ],
  "overrides": [
    {
      "date": "2025-03-07",
      "periods": [
        {
          "wday": "friday",
          "start_time": "11:00 AM",
          "end_time": "04:00 PM"
        }
      ]
    }
  ],
  "time_zone": "America/New_York"
}
'

{
  "message": "<string>",
  "availability": {
    "id": "01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a",
    "sid": "2nq7q5c",
    "name": "Availability for custom user",
    "default": false,
    "after_buffer_time": 0,
    "before_buffer_time": 0,
    "periods": [
      {
        "id": "21c812a7-3859-4f01-b214-850e6f11caad",
        "wday": "monday",
        "start_time": "09:00 AM",
        "end_time": "05:00 PM"
      }
    ],
    "overrides": [
      {
        "date": "2025-03-07",
        "periods": [
          {
            "wday": "friday",
            "start_time": "10:00 AM",
            "end_time": "03:00 PM"
          }
        ]
      }
    ],
    "user": {
      "id": "b6d02dfa-8ef6-453d-b9f7-67a6f20bcaa6",
      "name": "Oliver Smith",
      "email": "[email protected]"
    }
  }
}

Replace {your-workspace} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying your subdomain.

Headers

X-Api-Key

string

required

X-Api-Key is used to authenticate requests using an API key. Provide your API key in this header to access protected endpoints. Refer to Authentication for more information.

Path Parameters

availability_id

string

required

Id of the availability can be retrieved by going to the particular availability page, and copying it from the URL.

Body

application/json

periods

object[]

Hide child attributes

periods.wday

string

The weekday (e.g., "monday", "tuesday", etc.).

periods.start_time

string

Start time in "HH:MM AM/PM" format.

periods.end_time

string

End time in "HH:MM AM/PM" format.

Example:

[
  {
    "wday": "monday",
    "start_time": "09:00 AM",
    "end_time": "05:00 PM"
  },
  {
    "wday": "tuesday",
    "start_time": "11:00 AM",
    "end_time": "04:00 PM"
  }
]

overrides

object[]

Set an override for specific days. To set a date as unavailable, pass a blank array to the periods property. You can remove existing overrides by omitting the periods property.

Hide child attributes

overrides.date

string

The date (e.g, "2025-03-07")

overrides.periods

object[]

Set as blank ( [] ) to set a date as unavailable.

Hide child attributes

overrides.periods.wday

string

The weekday (e.g., "monday", "tuesday", etc.).

overrides.periods.start_time

string

Start time in "HH:MM AM/PM" format.

overrides.periods.end_time

string

End time in "HH:MM AM/PM" format.

Example:

[
  {
    "date": "2025-03-07",
    "periods": [
      {
        "wday": "friday",
        "start_time": "11:00 AM",
        "end_time": "04:00 PM"
      }
    ]
  }
]

time_zone

string

Optional IANA timezone name (e.g., "America/New_York", "Asia/Kolkata"). When provided, the start_time and end_time values in periods and overrides are assumed to be in this timezone and will be converted to the user's timezone before saving. If not provided, times are assumed to be in the user's timezone.

Example:

"America/New_York"

Response

200 - application/json

OK - Availability updated successfully

message

string

availability

object

Hide child attributes

availability.id

string

Unique identifier for the availability configuration.

Example:

"01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a"

availability.sid

string

Short identifier (SID) for the availability, used in URLs and API calls for easy reference.

Example:

"2nq7q5c"

availability.name

string

Human-readable name for the availability configuration (e.g., "Working hours", "Custom schedule").

Example:

"Availability for custom user"

availability.default

boolean

Indicates whether this is the default availability configuration for the team member. Only one availability can be set as default per user.

Example:

false

availability.after_buffer_time

integer

Buffer time in minutes after each meeting to allow for wrap-up, notes, or preparation for the next meeting.

Example:

0

availability.before_buffer_time

integer

Buffer time in minutes before each meeting to allow for setup, preparation, or travel time.

Example:

0

availability.periods

object[]

List of time periods defining when the team member is available for meetings throughout the week.

Hide child attributes

availability.periods.id

string

Unique identifier for this specific availability period.

Example:

"21c812a7-3859-4f01-b214-850e6f11caad"

availability.periods.wday

enum<string>

Day of the week for this availability period. Valid values are "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday".

Available options:

monday,

tuesday,

wednesday,

thursday,

friday,

saturday,

sunday

Example:

"monday"

availability.periods.start_time

string

Start time of the availability period in 12-hour format with AM/PM designation.

Example:

"09:00 AM"

availability.periods.end_time

string

End time of the availability period in 12-hour format with AM/PM designation.

Example:

"05:00 PM"

availability.overrides

object[]

List of date-specific availability overrides (e.g., holidays, vacation days, or special working hours for specific dates).

Hide child attributes

availability.overrides.date

string<date>

The specific date for this availability override in YYYY-MM-DD format.

Example:

"2025-03-07"

availability.overrides.periods

object[]

Time periods for this specific date. Set as empty array ([]) to mark the date as unavailable. If periods are provided, they override the regular weekly schedule for this date.

Hide child attributes

availability.overrides.periods.wday

enum<string>

Day of the week corresponding to the override date. Valid values are "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday".

Available options:

monday,

tuesday,

wednesday,

thursday,

friday,

saturday,

sunday

Example:

"friday"

availability.overrides.periods.start_time

string

Start time for the override period in 12-hour format with AM/PM designation.

Example:

"10:00 AM"

availability.overrides.periods.end_time

string

End time for the override period in 12-hour format with AM/PM designation.

Example:

"03:00 PM"

availability.user

object

Information about the team member this availability configuration belongs to.

Hide child attributes

availability.user.id

string

Unique identifier for the user/team member.

Example:

"b6d02dfa-8ef6-453d-b9f7-67a6f20bcaa6"

availability.user.name

string

Full name of the team member.

Example:

"Oliver Smith"

availability.user.email

string<email>

Email address of the team member.

Example:

"[email protected]"

Create an availability Create custom availability for scheduling-link

⌘I

Getting Started

Scheduling links API

Meeting places API

Meeting durations API

Bookings API

Availabilities API

Slots API

Packages API

Team Members API

Discount Codes API

Automation Rules API

Update an availability

Headers

Path Parameters

Body

Response