---
title: "Update a single CalendarEntry"
method: PATCH
path: "/calendar_entries/{id}.json"
tags: ["Calendar Entries"]
---

# Update a single CalendarEntry

`PATCH /calendar_entries/{id}.json`

Outlines the parameters and data fields used when updating a single CalendarEntry

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string

## Headers

- `IF-MATCH` string
- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `_deleted` 'single' | 'future' — Flag to delete a specific instance of a recurring event.
    - `all_day` boolean — Whether or not the CalendarEntry is for all day.
    - `attendees` object[]
      - `id` integer — The unique identifier for a single Attendee associated with the CalendarEntry. The keyword `null` is not valid for this field. Not required for creating new Attendee, but required for updating or deleting existing ones.
      - `type` string — The type of attendee (Calendar, Contact)
      - `_destroy` boolean — Flag to delete a specific attendee.
    - `calendar_entry_event_type` object
      - `id` integer — The unique identifier for a single CalendarEntryEventType associated with the CalendarEntry. Use the keyword `null` to specify no association.
    - `calendar_owner` object
      - `id` integer — The unique identifier for a single Calendar associated with the CalendarEntry. The keyword `null` is not valid for this field.
    - `conference_meeting` object
      - `type` 'zoom' — The type of conference meeting. If no conference meeting is present or the user is in an ineligible pricing tier for this feature, it will be null.
    - `description` string — A detailed description of the CalendarEntry.
    - `end_at` string, date-time — The time the CalendarEntry ends (Expects an ISO-8601 timestamp).
    - `external_properties` object[]
      - `id` integer — The unique identifier for a single ExternalProperty associated with the CalendarEntry. The keyword `null` is not valid for this field.
      - `name` string — The ExternalProperty name. Note: **there is a limit of 5 external_properties per CalendarEntry**
      - `value` string — The ExternalProperty value.
      - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated ExternalProperty is present, the ExternalProperty is deleted from the CalendarEntry.
    - `location` string — The geographic location of the CalendarEntry.
    - `matter` object
      - `id` integer — The unique identifier for a single Matter associated with the CalendarEntry. Use the keyword `null` to specify no association.
    - `recurrence_rule` string — Recurrence rule for expanding recurring CalendarEntry. To convert an existing recurring event to a non-recurring event, `''` or `null` are valid values.
    - `send_email_notification` boolean — Whether the calendar Entry should send email notifications to attendees
    - `start_at` string, date-time — The time the CalendarEntry starts (Expects an ISO-8601 timestamp).
    - `summary` string — A short summary of the CalendarEntry.

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/versions/94a82114ec3b/schema)