Editing a meeting availability

Overview

The "Editing a meeting availability" API allows users to edit availabilities used in a meeting. Note that if the availability is used elsewhere, that would also be updated.

Usage

Base URL

https://<workspace>.neetocal.com/api/external/v1

Replace the <workspace> with your workspace's subdomain.

Endpoint

PATCH meetings/<meeting_sid>/availability

Replace the <meeting_sid> with the desired meeting SID.

Request header

This endpoint requires authentication. You must include a valid API key in the request header.

Header	Type	Required	Description
X-Api-Key	String	Yes	Bearer token for API access.

Request body

Key	Type	Required	Description
periods	String	Yes	An array containing the periods. More details given below.

periods: This can be used to set the availability. It should be an a list of objects. Each object should have three keys wday, start_time, and end_time. wday is the week day. It can be a value from sunday to saturday. Note that the value should be in lowercase. start_time and end_time should be in the format "HH:MMAM/PM" eg: "09:00AM". If multiple peroids are needed for the same days, it can be mentioned in separate object. Example given below.

[
  {
    "wday": "monday",
    "start_time": "09:00AM",
    "end_time": "05:00PM"
  },
  {
    "wday": "wednesday",
    "start_time": "09:00AM",
    "end_time": "01:00PM"
  },
  {
    "wday": "wednesday",
    "start_time": "02:00PM",
    "end_time": "07:00PM"
  }
]

Example

For updating an availability of the meeting with SID a8yjkzb of workspace "Spinkart" with subdomain spinkart using curl

curl --request POST \
  --url 'https://spinkart.neetocal.com/api/external/v1/meetings/a8yjkzb/availability' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "periods": [
      {
        "wday": "monday",
        "start_time": "09:00AM",
        "end_time": "05:00PM"
      },
      {
        "wday": "wednesday",
        "start_time": "09:00AM",
        "end_time": "01:00PM"
      },
      {
        "wday": "wednesday",
        "start_time": "02:00PM",
        "end_time": "07:00PM"
      }
    ]
  }'

Response Codes

Code	Description
200	OK - Request succeeded
400	Bad Request - Missing/Invalid parameters
401	Unauthorized - Invalid API key
500	Internal server error