# community.lexicon.calendar.event

> Published by [lexicon.community](https://lexicon.garden/identity/did:plc:2uwoih2htodskvgocarwv5eq)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2uwoih2htodskvgocarwv5eq/community.lexicon.calendar.event)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2uwoih2htodskvgocarwv5eq/community.lexicon.calendar.event/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2uwoih2htodskvgocarwv5eq/community.lexicon.calendar.event/examples)

## Definitions

### `community.lexicon.calendar.event#uri`

**Type**: `object`

A URI associated with the event.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (uri) | Yes |  |
| `name` | `string` | No | The display name of the URI. |

### `community.lexicon.calendar.event`

**Type**: `record`

A calendar event.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `mode` | `ref` → `community.lexicon.calendar.event#mode` | No | The attendance mode of the event. |
| `name` | `string` | Yes | The name of the event. |
| `uris` | `array` | No | URIs associated with the event. |
| `endsAt` | `string` (datetime) | No | Client-declared timestamp when the event ends. |
| `status` | `ref` → `community.lexicon.calendar.event#status` | No | The status of the event. |
| `startsAt` | `string` (datetime) | No | Client-declared timestamp when the event starts. |
| `createdAt` | `string` (datetime) | Yes | Client-declared timestamp when the event was created. |
| `locations` | `array` | No | The locations where the event takes place. |
| `description` | `string` | No | The description of the event. |

### `community.lexicon.calendar.event#mode`

**Type**: `string`

The mode of the event.

**Known Values**:
- `community.lexicon.calendar.event#hybrid`
- `community.lexicon.calendar.event#inperson`
- `community.lexicon.calendar.event#virtual`

### `community.lexicon.calendar.event#hybrid`

**Type**: `token`

A hybrid event that takes place both online and offline.

A hybrid event that takes place both online and offline.

### `community.lexicon.calendar.event#status`

**Type**: `string`

The status of the event.

**Known Values**:
- `community.lexicon.calendar.event#cancelled`
- `community.lexicon.calendar.event#planned`
- `community.lexicon.calendar.event#postponed`
- `community.lexicon.calendar.event#rescheduled`
- `community.lexicon.calendar.event#scheduled`

### `community.lexicon.calendar.event#planned`

**Type**: `token`

The event has been created, but not finalized.

The event has been created, but not finalized.

### `community.lexicon.calendar.event#virtual`

**Type**: `token`

A virtual event that takes place online.

A virtual event that takes place online.

### `community.lexicon.calendar.event#inperson`

**Type**: `token`

An in-person event that takes place offline.

An in-person event that takes place offline.

### `community.lexicon.calendar.event#cancelled`

**Type**: `token`

The event has been cancelled.

The event has been cancelled.

### `community.lexicon.calendar.event#postponed`

**Type**: `token`

The event has been postponed and a new start date has not been set.

The event has been postponed and a new start date has not been set.

### `community.lexicon.calendar.event#scheduled`

**Type**: `token`

The event has been created and scheduled.

The event has been created and scheduled.

### `community.lexicon.calendar.event#rescheduled`

**Type**: `token`

The event has been rescheduled.

The event has been rescheduled.

## Examples

The following examples demonstrate valid data for this lexicon. [View all examples](https://lexicon.garden/lexicon/did:plc:2uwoih2htodskvgocarwv5eq/community.lexicon.calendar.event/examples)

### Example 1 (`#main`)

**Description**: An example event with a facet.

```json
{
  "mode": "community.lexicon.calendar.event#hybrid",
  "name": "Zero Cool Day",
  "$type": "community.lexicon.calendar.event",
  "facets": [
    {
      "index": {
        "byteEnd": 361,
        "byteStart": 318
      },
      "features": [
        {
          "uri": "https://en.wikipedia.org/wiki/Hackers_(film",
          "$type": "app.bsky.richtext.facet#link"
        }
      ]
    }
  ],
  "status": "community.lexicon.calendar.event#scheduled",
  "startsAt": "2026-08-10T14:00:00.000Z",
  "createdAt": "2025-11-12T22:54:25.013Z",
  "description": "\"Zero Cool? Crashed fifteen hundred and seven computers in one day? Biggest crash in history, front page New York Times August 10th, 1988. I thought you was black man. YO THIS IS ZERO COOL!\" - Paul \"Lord Nikon\" Cook\n\nJoin us in celebrating Zero Cool Day by sipping on some jolt cola and hacking your favorite Gibson.\n\nhttps://en.wikipedia.org/wiki/Hackers_(film)"
}
```

### Example 2 (`#uri`)

**Description**: An example event uri

```json
{
  "uri": "https://smokesignal.events/",
  "name": "Smoke Signal",
  "$type": "community.lexicon.calendar.event#uri"
}
```

## Raw Schema

```json
{
  "id": "community.lexicon.calendar.event",
  "defs": {
    "uri": {
      "type": "object",
      "required": [
        "uri"
      ],
      "properties": {
        "uri": {
          "type": "string",
          "format": "uri"
        },
        "name": {
          "type": "string",
          "description": "The display name of the URI."
        }
      },
      "description": "A URI associated with the event."
    },
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "createdAt",
          "name"
        ],
        "properties": {
          "mode": {
            "ref": "community.lexicon.calendar.event#mode",
            "type": "ref",
            "description": "The attendance mode of the event."
          },
          "name": {
            "type": "string",
            "description": "The name of the event."
          },
          "uris": {
            "type": "array",
            "items": {
              "ref": "community.lexicon.calendar.event#uri",
              "type": "ref"
            },
            "description": "URIs associated with the event."
          },
          "endsAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when the event ends."
          },
          "status": {
            "ref": "community.lexicon.calendar.event#status",
            "type": "ref",
            "description": "The status of the event."
          },
          "startsAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when the event starts."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when the event was created."
          },
          "locations": {
            "type": "array",
            "items": {
              "refs": [
                "community.lexicon.calendar.event#uri",
                "community.lexicon.location.address",
                "community.lexicon.location.fsq",
                "community.lexicon.location.geo",
                "community.lexicon.location.hthree"
              ],
              "type": "union"
            },
            "description": "The locations where the event takes place."
          },
          "description": {
            "type": "string",
            "description": "The description of the event."
          }
        }
      },
      "description": "A calendar event."
    },
    "mode": {
      "type": "string",
      "default": "community.lexicon.calendar.event#inperson",
      "description": "The mode of the event.",
      "knownValues": [
        "community.lexicon.calendar.event#hybrid",
        "community.lexicon.calendar.event#inperson",
        "community.lexicon.calendar.event#virtual"
      ]
    },
    "hybrid": {
      "type": "token",
      "description": "A hybrid event that takes place both online and offline."
    },
    "status": {
      "type": "string",
      "default": "community.lexicon.calendar.event#scheduled",
      "description": "The status of the event.",
      "knownValues": [
        "community.lexicon.calendar.event#cancelled",
        "community.lexicon.calendar.event#planned",
        "community.lexicon.calendar.event#postponed",
        "community.lexicon.calendar.event#rescheduled",
        "community.lexicon.calendar.event#scheduled"
      ]
    },
    "planned": {
      "type": "token",
      "description": "The event has been created, but not finalized."
    },
    "virtual": {
      "type": "token",
      "description": "A virtual event that takes place online."
    },
    "inperson": {
      "type": "token",
      "description": "An in-person event that takes place offline."
    },
    "cancelled": {
      "type": "token",
      "description": "The event has been cancelled."
    },
    "postponed": {
      "type": "token",
      "description": "The event has been postponed and a new start date has not been set."
    },
    "scheduled": {
      "type": "token",
      "description": "The event has been created and scheduled."
    },
    "rescheduled": {
      "type": "token",
      "description": "The event has been rescheduled."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```