---
title: "Update an existing calendar"
method: PATCH
path: "/v2/org/{orgId}/calendar/{calendarId}"
tags: ["calendar"]
---

# Update an existing calendar

`PATCH /v2/org/{orgId}/calendar/{calendarId}`

## Path parameters

- `orgId` string, required
- `calendarId` string, required

## Request body

- UpdateCalendar
  - `type` 'ANNIVERSARY' | 'BIRTHDAY' | 'COMP_REVIEW' | 'REVIEW' | 'SURVEY' | 'TASK' | 'TIMEOFF' | 'START_DATE' | 'END_DATE' | 'CUSTOM' | 'HOLIDAY' — type of calendar
  - `label` string — human-readable label for calendar
  - `description` string
  - `color` string
  - `imagePath` string
  - `emoji` string — emoji, if an emoji is used to represent the calendar
  - `sensitive` 'GLOBAL' | 'ORG' | 'SENSITIVE' | 'PERSONAL' | 'MANAGER' | 'HIGH' | 'PRIVATE' — base sensitivity of this calendar and entities in it -- should be PRIVATE, ORG or HIGH
  - `shareAccess` ShareAccess[] — list of users and groups who have the content shared with them
    - `access` 'NONE' | 'LIMITED_READ' | 'LIMITED_WRITE' | 'STANDARD_READ' | 'STANDARD_WRITE' | 'COMPENSATION_READ' | 'FULL_READ' | 'COMP_PLANNING_PARTICIPANT' | 'COMPENSATION_WRITE' | 'WRITE' | 'COMPENSATION_OWNER' | 'OWNER', required — access permission level
    - `userId` string — user id
    - `groupId` string — group id
    - `fields` string — fields
  - `status` 'ACTIVE' | 'INACTIVE' — whether the calendar is active or not
  - `eligibility` CalendarEligibility
    - `filter` string — CQL filter selecting the people this calendar applies to; blank matches everyone
    - `includePersonIds` string[] — personIds always included, regardless of the filter
    - `excludePersonIds` string[] — personIds always excluded, even if they match the filter

## Response `204`

No Content

---

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