Skip to main content
PATCH
/
meetings
/
{meeting_sid}
Update a scheduling link
curl --request PATCH \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/meetings/{meeting_sid} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "hosts": [
    "oliver@example.com",
    "jane@example.com"
  ],
  "slug": "meeting-with-oliver-smith-new",
  "name": "Meeting with Oliver Smith",
  "description": "Discuss project updates",
  "kind": "one_on_one",
  "duration": 30,
  "start_time_increment": 30,
  "before_buffer_time": 0,
  "after_buffer_time": 0,
  "spot_phone_call_number": "+1-555-0123",
  "spot_custom_text": "Custom meeting instructions",
  "spot_in_person_location": "123 Main St, Suite 100",
  "locked_time_zone": "America/New_York"
}
'
{
  "message": "<string>",
  "meeting": {
    "id": "<string>",
    "sid": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "description": "<string>",
    "duration": 123,
    "disabled": true,
    "spot_in_person_location": "<string>",
    "spot_custom_text": "<string>",
    "spot_phone_call_number": "<string>",
    "is_template": true,
    "schedulable_range_value": "<string>",
    "lead_time": 123,
    "start_time_increment": 123,
    "before_buffer_time": 0,
    "after_buffer_time": 0,
    "created_at": "2025-12-23T05:05:27.037Z",
    "updated_at": "2025-03-31T13:22:19.832Z",
    "deleted_at": null,
    "is_multiple_spots_allowed": true,
    "is_multiple_durations_allowed": true,
    "conditional_pricing_enabled": true,
    "is_email_reminders_enabled": true,
    "is_sms_reminders_enabled": true,
    "organization_id": "<string>",
    "rescheduling_lead_time": 123,
    "cancellation_lead_time": 123,
    "booking_modification_allowed": true,
    "cancellation_too_late_notice": "<string>",
    "cancellation_policy": "<string>",
    "rescheduling_too_late_notice": "<string>",
    "pre_booking_allowed": true,
    "original_price_enabled": true,
    "original_price": 123,
    "locked_time_zone": "America/New_York",
    "fees": [
      {
        "id": "1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9",
        "amount": "120.0",
        "currency": "inr",
        "feeable_id": "aff17ff8-1bf8-4e77-a3c5-2f86104f9a20",
        "feeable_type": "Meeting",
        "payment_provider": "cash",
        "kind": "fixed",
        "min_amount": "120.0",
        "is_default": true,
        "display_amount": "<string>",
        "is_tax_enabled": true,
        "is_tip_enabled": true,
        "is_tax_applicable_on_tip": true,
        "vpas": [
          {}
        ],
        "recipient": {
          "id": "<string>",
          "fee_id": "<string>",
          "accountable": {}
        },
        "amount_in_smallest_currency_unit": 12000
      }
    ],
    "durations_possible": [
      123
    ],
    "durations": [
      {
        "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
        "duration": 30,
        "is_default": false,
        "created_at": "2025-08-18T07:43:16.775Z",
        "updated_at": "2025-08-18T08:03:58.019Z"
      }
    ],
    "hosts": [
      {
        "name": "Oliver Smith",
        "email": "oliver@example.com"
      }
    ],
    "spots": [
      {
        "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
        "spot": "jitsi",
        "is_default": false,
        "phone_call_number": null,
        "in_person_location": null,
        "custom_text": null,
        "created_at": "2025-08-18T07:19:28.341Z",
        "updated_at": "2025-08-18T07:35:32.822Z"
      }
    ]
  }
}
Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

​
X-Api-Key
string
required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

Path Parameters

​
meeting_sid
string
required

Id of the scheduling link you want to update.

Body

application/json
​
hosts
string[]
required

Emails of the hosts of scheduling link in array format.

Example:
["oliver@example.com", "jane@example.com"]
​
slug
string

New slug of the scheduling link. This value should be unique.

Example:

"meeting-with-oliver-smith-new"

​
name
string

New name of the scheduling link.

Example:

"Meeting with Oliver Smith"

​
description
string

Description of the scheduling link.

Example:

"Discuss project updates"

​
kind
enum<string>
default:one_on_one

Kind of scheduling link.

Available options:
one_on_one,
round_robin,
multihost,
grouped
​
duration
integer

Duration of the scheduling link in minutes.

Example:

30

​
start_time_increment
integer

Start time increment for the scheduling link in minutes. Defaults to 30.

Example:

30

​
before_buffer_time
integer

Buffer time in minutes before each meeting to allow for setup, preparation, or travel time. Must be between 0 and 1440 (24 hours).

Required range: 0 <= x <= 1440
Example:

0

​
after_buffer_time
integer

Buffer time in minutes after each meeting to allow for wrap-up, notes, or preparation for the next meeting. Must be between 0 and 1440 (24 hours).

Required range: 0 <= x <= 1440
Example:

0

​
spot_phone_call_number
string

Phone number for the meeting when place is set to phone_call.

Example:

"+1-555-0123"

​
spot_custom_text
string

Custom meeting instructions or details when meeting place is set to custom.

Example:

"Custom meeting instructions"

​
spot_in_person_location
string

Physical location details when meeting place is set to in_person.

Example:

"123 Main St, Suite 100"

​
locked_time_zone
string

Time zone to lock the scheduling link to. When set, all available times are displayed in this time zone regardless of the booker's location. Must be a valid IANA time zone identifier (e.g., 'America/New_York', 'Europe/London').

Example:

"America/New_York"

Response

200 - application/json

OK - Request succeeded

​
message
string
​
meeting
object