---
title: "Update Calendar"
method: POST
path: "/v1/calendars/update"
tags: ["Calendars"]
---

# Update Calendar

`POST /v1/calendars/update`

Update a calendar's settings. Only the provided fields are changed.

## Request body

- object
  - `calendar_id` string, required — Calendar ID, this usually starts with cal-.
  - `name` string — Name of the calendar.
  - `slug` string — URL slug for the calendar page (e.g. 'my-community' → lu.ma/my-community).
  - `description` string — Short description of the calendar.
  - `avatar_url` string, uri — Specify an image that has been uploaded to the Luma CDN.
  - `tint_color` string — Tint color for the calendar in hex format (e.g. '#E3CBEF').

## Response `200`

Successful response.

- object
  - `id` string, required
  - `name` string, required
  - `slug` string, nullable, required
  - `avatar_url` string, nullable, required
  - `url` string, required
  - `description` string, nullable, required
  - `social_image_url` string, nullable, required
  - `cover_image_url` string, nullable, required
  - `is_personal` boolean, required
  - `location` object, nullable, required — City the calendar is based in (e.g. for city calendars). Null when the calendar isn't tied to a place.
    - `city` string, required — City name, e.g. 'New York'.
    - `region` string, nullable, required — State or province, e.g. 'New York' or 'California'.
    - `country` string, nullable, required — Country name, e.g. 'United States'. Null for cities in disputed territories where Google omits the country.
    - `country_code` string, nullable, required — ISO 3166-1 alpha-2 country code, e.g. 'US'.
    - `timezone` string, required — IANA timezone of the city, e.g. 'America/New_York'.
  - `coordinate` object, nullable, required — Latitude and longitude of the calendar's primary location (e.g. city calendars). Null when the calendar isn't tied to a place.
    - `longitude` number, required
    - `latitude` number, required
  - `instagram_handle` string, nullable, required
  - `twitter_handle` string, nullable, required
  - `youtube_handle` string, nullable, required
  - `website` string, nullable, required

---

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