Change a meeting

PATCH
/v1/calendar/events/{id}

Moves a meeting, or changes its guests or description, and tells the guests. A repeating meeting is changed one date at a time, with that date's own id; changing the whole series is refused with series_edit_refused because the person's calendar owns it.

Requires an API key with the calendar:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The meeting id, from the list of meetings. For a repeating meeting, the id of the single date.

Length1 <= length

Request Body

application/json
  1. body
start?string

The new start. Give the new end too.

Formatdate-time
end?string

The new end. Give the new start too.

Formatdate-time
description?string

The new description.

Lengthlength <= 8000
attendees?array<>

The full guest list, replacing the old one.

Itemsitems <= 100
calendarId?string

Which calendar the meeting is on.

Length1 <= length <= 320
mailbox?string

An agent's email address, to use that mailbox's own calendar.

Lengthlength <= 320
connectionId?string

Only needed when more than one calendar account is connected.

Length1 <= length <= 64

Response Body

The meeting after the change

application/json
  1. response
event*
summary*string
Example Request
curl -X PATCH "https://api.vlayers.ai/v1/calendar/events/$EVENT_ID" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "start": "2026-11-06T15:00:00.000Z",    "end": "2026-11-06T15:30:00.000Z"  }'
Example Response
{  "event": {    "id": "evt_91",    "calendarId": "primary",    "title": "Demo call",    "description": "Intro and pricing",    "location": "",    "start": "2026-11-05T15:00:00.000Z",    "end": "2026-11-05T15:30:00.000Z",    "allDay": false,    "timeZone": "UTC",    "attendees": [      {        "email": "[email protected]",        "name": "Pat",        "response": "accepted"      }    ],    "organizerEmail": "[email protected]",    "recurrence": "none",    "seriesId": null,    "repeats": null,    "joinUrl": null,    "cancelled": false,    "iCalUid": null  },  "summary": "Updated \"Demo call\". Guests were told about the change."}