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

> ## Agent Instructions
> Charter works for any HTTP API, including the user's own. The packs are examples of the result, not the limit: an API with no pack is declared the same way, following https://raw.githubusercontent.com/r28ai/charter/main/docs/.mintlify/skills/declaring-charter-tools/SKILL.md.
> Charter is for agents that act in customers' accounts: every call is checked field by field before it's sent, the app says whose account each call is for, and the same declarations list what each tool can reach. https://docs.r28.ai/charter/llms.txt says what it is and lists every page.

# Objects

> Every object and enum the Calendars tools accept.

## Model tree

[CalendarsEventsAddBodyExternal](#calendarseventsaddbodyexternal)[CalendarsEventsAddBodyLuma](#calendarseventsaddbodyluma)[LocationGoogle](#locationgoogle)[LocationLookup](#locationlookup)[EventDefaults](#eventdefaults)[EventDefaultsFeedbackEmail](#eventdefaultsfeedbackemail)

## CalendarsEventsAddBodyExternal

Declared inline in the spec: `CalendarsEventsAdd.body_external`.

| Field | Type | Description |
| - | - | - |
| `platform` \* | `string` | — |
| `submissionMode` | `"auto" \| "pending"` | `auto` approves the event immediately. `pending` keeps the event pending for calendar admin approval. Defaults to `auto` when omitted. |
| `url` \* | `string` | — |
| `name` \* | `string` | — |
| `startAt` \* | `string` | ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z |
| `durationInterval` \* | `string` | ISO 8601 Duration. For example, PT2H |
| `timezone` \* | `string` | IANA Timezone, e.g. America/New\_York. [https://en.wikipedia.org/wiki/List\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) |
| `geoAddressJson` | [GeoAddressJsonManual](https://docs.r28.ai/charter/charter/packs/luma/events/objects.md#geoaddressjsonmanual) \| [GeoAddressJsonGoogle](https://docs.r28.ai/charter/charter/packs/luma/events/objects.md#geoaddressjsongoogle) \| [GeoAddressJsonLookup](https://docs.r28.ai/charter/charter/packs/luma/events/objects.md#geoaddressjsonlookup) | — |
| `host` | `string` | — |

## CalendarsEventsAddBodyLuma

Declared inline in the spec: `CalendarsEventsAdd.body_luma`.

| Field | Type | Description |
| - | - | - |
| `platform` \* | `string` | — |
| `submissionMode` | `"auto" \| "pending"` | `auto` approves the event immediately. `pending` keeps the event pending for calendar admin approval. Defaults to `auto` when omitted. |
| `eventId` | `string` | Event ID, this usually starts with evt- |

## LocationGoogle

Resolves a Google Maps Place ID for a city.

| Field | Type | Description |
| - | - | - |
| `type` \* | `string` | — |
| `placeId` \* | `string` | min length 1 |

## LocationLookup

Searches Google Maps for a city matching `query` (e.g. "Miami Beach, FL") and uses the top result.

| Field | Type | Description |
| - | - | - |
| `type` \* | `string` | — |
| `query` \* | `string` | min length 1 |

## EventDefaults

Settings new events on this calendar start with. Only the provided fields change, and existing events aren't affected. `visibility: 'members-only'` requires a membership tier on the calendar.

| Field | Type | Description |
| - | - | - |
| `visibility` | [Visibility](https://docs.r28.ai/charter/charter/packs/luma/events/objects.md#visibility) | Visibility of new events. `members-only` requires a membership tier on the calendar. |
| `showGuestList` | `boolean` | Whether new events show their guest list. |
| `feedbackEmail` | [EventDefaultsFeedbackEmail](#eventdefaultsfeedbackemail) | Whether new events send the post-event feedback email. Each event can override this with its own `feedback_email`. |

## EventDefaultsFeedbackEmail

Whether new events send the post-event feedback email. Each event can override this with its own `feedback_email`.

| Field | Type | Description |
| - | - | - |
| `enabled` \* | `boolean` | — |

## MembershipStatus

| Value |
| - |
| `approved` |
| `pending` |
| `approved-pending-payment` |
| `declined` |

## CalendarsContactsListSortColumn

| Value |
| - |
| `created_at` |
| `event_checked_in_count` |
| `event_approved_count` |
| `name` |
| `revenue_usd_cents` |

## Color

| Value |
| - |
| `cranberry` |
| `barney` |
| `red` |
| `green` |
| `blue` |
| `purple` |
| `yellow` |
| `orange` |

## LaunchStatus

| Value |
| - |
| `launched` |
| `coming-soon` |
| `archived` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.