PATCH
/
v2
/
calendars
/
{calendar}
/
events
/
{eventUid}
Update meeting details in calendar
curl --request PATCH \
  --url https://api.cal.com/v2/calendars/{calendar}/events/{eventUid} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "start": {
    "time": "2023-11-07T05:31:56Z",
    "timeZone": "<string>"
  },
  "end": {
    "time": "2023-11-07T05:31:56Z",
    "timeZone": "<string>"
  },
  "title": "<string>",
  "description": "<string>",
  "attendees": [
    {
      "email": "<string>",
      "name": "<string>",
      "responseStatus": "accepted",
      "self": true,
      "optional": true,
      "host": true
    }
  ],
  "status": "accepted"
}'
{
  "status": "success",
  "data": {
    "start": {
      "time": "2023-11-07T05:31:56Z",
      "timeZone": "<string>"
    },
    "end": {
      "time": "2023-11-07T05:31:56Z",
      "timeZone": "<string>"
    },
    "id": "<string>",
    "title": "<string>",
    "description": "<string>",
    "locations": [
      {
        "type": "video",
        "url": "<string>",
        "label": "<string>",
        "password": "<string>",
        "meetingCode": "<string>",
        "accessCode": "<string>"
      }
    ],
    "attendees": [
      {
        "email": "<string>",
        "name": "<string>",
        "responseStatus": "accepted",
        "self": true,
        "optional": true,
        "host": true
      }
    ],
    "status": "accepted",
    "hosts": [
      {
        "email": "<string>",
        "name": "<string>",
        "responseStatus": "accepted"
      }
    ],
    "calendarEventOwner": {
      "email": "<string>",
      "name": "<string>"
    },
    "source": "google"
  }
}

Headers

​
Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

Path Parameters

​
calendar
enum<string>
required
Available options:
google
​
eventUid
string
required

The Google Calendar event ID. You can retrieve this by getting booking references from the following endpoints:

Body

application/json
​
start
object

Start date and time of the calendar event with timezone information

​
end
object

End date and time of the calendar event with timezone information

​
title
string

Title of the calendar event

​
description
string | null

Detailed description of the calendar event

​
attendees
object[] | null

List of attendees. CAUTION: You must pass the entire array with all updated values. Any attendees not included in this array will be removed from the event.

​
status
enum<string>

Status of the event (accepted, pending, declined, cancelled)

Available options:
accepted,
pending,
declined,
cancelled

Response

200 - application/json
​
status
enum<string>
required
Available options:
success,
error
Example:

"success"

​
data
object
required