---
title: "Update an event"
method: PATCH
path: "/calendar/{connection_id}/event/{id}"
tags: ["calendar", "event"]
---

# Update an event

`PATCH /calendar/{connection_id}/event/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- CalendarEvent
  - `id` string
  - `created_at` string
  - `updated_at` string
  - `calendar_id` string
  - `subject` string
  - `start_at` string
  - `end_at` string
  - `is_all_day` boolean
  - `timezone` string
  - `notes` string
  - `location` string
  - `is_free` boolean
  - `is_private` boolean
  - `status` 'CANCELED' | 'CONFIRMED' | 'TENTATIVE'
  - `organizer` PropertyCalendarEventOrganizer
    - `user_id` string
    - `email` string
    - `name` string
    - `status` 'ACCEPTED' | 'REJECTED' | 'TENTATIVE'
    - `required` boolean
    - `is_cohost` boolean
  - `attendees` CalendarAttendee[]
    - `user_id` string
    - `email` string
    - `name` string
    - `status` 'ACCEPTED' | 'REJECTED' | 'TENTATIVE'
    - `required` boolean
    - `is_cohost` boolean
  - `recurring_event_id` string
  - `recurrence` CalendarEventRecurrence[]
    - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY'
    - `interval` number
    - `count` number
    - `end_at` string, date-time
    - `on_days` string[] — days of the week to repeat on, defaults to undefined (every day), only used if frequency is WEEKLY
    - `on_months` number[] — months of the year to repeat on, defaults to undefined (every month), only used if frequency is YEARLY, January is 1
    - `on_month_days` number[] — days of the month to repeat on, defaults to undefined (every day), only used if frequency is MONTHLY
    - `on_weeks` number[] — week ordinals for BYDAY (e.g., -1 for last, -2 for second-to-last, 1 for first, 2 for second), only used with on_days. 0 is used for days without week ordinals.
    - `on_year_days` number[] — days of the year to repeat on, defaults to undefined (every day), only used if frequency is YEARLY
    - `week_start` 'SU' | 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA'
    - `excluded_dates` string[] — dates to exclude from the recurrence, defaults to undefined (no exclusions)
    - `included_dates` string[] — dates to include in the recurrence, defaults to undefined (no inclusions)
    - `timezone` string
  - `web_url` string
  - `has_conference` boolean
  - `conference` CalendarConference[]
    - `conference_identifier` string
    - `url` string
    - `label` string
    - `telephone` string
    - `participant_access_code` string
    - `host_access_code` string
    - `notes` string
    - `country_code` string
    - `region_code` string
  - `attachments` CalendarAttachment[]
    - `id` string
    - `name` string
    - `mime_type` string
    - `download_url` string
  - `send_notifications` boolean
  - `raw` object

## Response `200`

Successful

- CalendarEvent
  - `id` string
  - `created_at` string
  - `updated_at` string
  - `calendar_id` string
  - `subject` string
  - `start_at` string
  - `end_at` string
  - `is_all_day` boolean
  - `timezone` string
  - `notes` string
  - `location` string
  - `is_free` boolean
  - `is_private` boolean
  - `status` 'CANCELED' | 'CONFIRMED' | 'TENTATIVE'
  - `organizer` PropertyCalendarEventOrganizer
    - `user_id` string
    - `email` string
    - `name` string
    - `status` 'ACCEPTED' | 'REJECTED' | 'TENTATIVE'
    - `required` boolean
    - `is_cohost` boolean
  - `attendees` CalendarAttendee[]
    - `user_id` string
    - `email` string
    - `name` string
    - `status` 'ACCEPTED' | 'REJECTED' | 'TENTATIVE'
    - `required` boolean
    - `is_cohost` boolean
  - `recurring_event_id` string
  - `recurrence` CalendarEventRecurrence[]
    - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY'
    - `interval` number
    - `count` number
    - `end_at` string, date-time
    - `on_days` string[] — days of the week to repeat on, defaults to undefined (every day), only used if frequency is WEEKLY
    - `on_months` number[] — months of the year to repeat on, defaults to undefined (every month), only used if frequency is YEARLY, January is 1
    - `on_month_days` number[] — days of the month to repeat on, defaults to undefined (every day), only used if frequency is MONTHLY
    - `on_weeks` number[] — week ordinals for BYDAY (e.g., -1 for last, -2 for second-to-last, 1 for first, 2 for second), only used with on_days. 0 is used for days without week ordinals.
    - `on_year_days` number[] — days of the year to repeat on, defaults to undefined (every day), only used if frequency is YEARLY
    - `week_start` 'SU' | 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA'
    - `excluded_dates` string[] — dates to exclude from the recurrence, defaults to undefined (no exclusions)
    - `included_dates` string[] — dates to include in the recurrence, defaults to undefined (no inclusions)
    - `timezone` string
  - `web_url` string
  - `has_conference` boolean
  - `conference` CalendarConference[]
    - `conference_identifier` string
    - `url` string
    - `label` string
    - `telephone` string
    - `participant_access_code` string
    - `host_access_code` string
    - `notes` string
    - `country_code` string
    - `region_code` string
  - `attachments` CalendarAttachment[]
    - `id` string
    - `name` string
    - `mime_type` string
    - `download_url` string
  - `send_notifications` boolean
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)