> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar

> Calendars group related events in your Plane workspace.

A calendar is a named collection of [calendar events](/reference/calendar-events/object)
in your workspace. Plane uses calendars to organize company events, time off, payroll dates,
and other schedule-related entries.

### Attributes

<ResponseField name="id" type="string">
  Unique identifier for the calendar, for example `cal_cNqYX2J3s9bI2Aa`.
</ResponseField>

<ResponseField name="object" type="string">
  The object type. Always `calendar`.
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable name for the calendar.
</ResponseField>

<ResponseField name="description" type="string | null">
  Optional description of what the calendar contains.
</ResponseField>

<ResponseField name="purpose" type="array">
  Tags that identify what the calendar is used for. Known values include `holidays`, `leaves`,
  `anniversaries`, and `starting`. This list is not exhaustive.
</ResponseField>

<ResponseField name="metadata" type="object">
  Set of key-value pairs attached to the calendar.
</ResponseField>

<ResponseField name="created" type="string">
  Timestamp of when the calendar was created.
</ResponseField>

<ResponseField name="updated" type="string">
  Timestamp of when the calendar was last updated.
</ResponseField>