# email.atmos.calendar.proposal

> ALPHA. Append-only proposed Calendar event edit. Host validates identity, permissions and causal history before accepting records.

- Kind: record
- Record key: any
- Authority: calendar.atmos.email
- Lexicon: 1
- Published by [comail.at](https://lexicon.garden/identity/did:plc:yu6rmwoemqfnmsdkljyvmuhg), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:yu6rmwoemqfnmsdkljyvmuhg/email.atmos.calendar.proposal)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:yu6rmwoemqfnmsdkljyvmuhg/email.atmos.calendar.proposal/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:yu6rmwoemqfnmsdkljyvmuhg/email.atmos.calendar.proposal/analytics)

## Record (`email.atmos.calendar.proposal`)

Type: record · key any

### Properties

- `payload` (ref, required)
  - Reference: `#payload`

## #eventPatch (`email.atmos.calendar.proposal#eventPatch`)

Type: object

### Properties

- `description` (string)
  - Constraints: maxLength: 16384
- `duration` (string): ISO 8601 duration; zero is allowed.
- `participants` (array)
  - Constraints: maxLength: 100
  - `items` (ref)
    - Reference: `#participant`
- `recurrenceOverrides` (unknown): Map from local recurrence timestamps to partial event overrides. Validated by Host.
- `recurrenceRules` (array)
  - Constraints: minLength: 1, maxLength: 1
  - `items` (ref)
    - Reference: `#recurrenceRule`
- `showWithoutTime` (boolean)
- `start` (string): Local date and time, YYYY-MM-DDTHH:mm:ss, interpreted in timeZone.
- `status` (string)
  - Constraints: knownValues: confirmed | cancelled
- `timeZone` (string)
- `title` (string)
  - Constraints: minLength: 1, maxLength: 4096

## #participant (`email.atmos.calendar.proposal#participant`)

Type: object

### Properties

- `did` (string · did, required)
- `status` (string, required)
  - Constraints: knownValues: accepted | declined | tentative

## #payload (`email.atmos.calendar.proposal#payload`)

Type: object

### Properties

- `author` (string · did, required)
- `base` (string, required)
  - Constraints: minLength: 1, maxLength: 256
- `eventId` (string, required)
  - Constraints: minLength: 1, maxLength: 256
- `id` (string, required)
  - Constraints: minLength: 1, maxLength: 256
- `patch` (ref, required)
  - Reference: `#eventPatch`
- `policy` (string, required)
  - Constraints: minLength: 1, maxLength: 256
- `recurrenceId` (string)

## #recurrenceRule (`email.atmos.calendar.proposal#recurrenceRule`)

Type: object

### Properties

- `count` (integer, required)
  - Constraints: minimum: 1, maximum: 1000
- `frequency` (string, required)
  - Constraints: knownValues: daily | weekly
- `interval` (integer)
  - Constraints: minimum: 1, maximum: 52

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "eventPatch": {
      "properties": {
        "description": {
          "maxLength": 16384,
          "type": "string"
        },
        "duration": {
          "description": "ISO 8601 duration; zero is allowed.",
          "type": "string"
        },
        "participants": {
          "items": {
            "ref": "#participant",
            "type": "ref"
          },
          "maxLength": 100,
          "type": "array"
        },
        "recurrenceOverrides": {
          "description": "Map from local recurrence timestamps to partial event overrides. Validated by Host.",
          "type": "unknown"
        },
        "recurrenceRules": {
          "items": {
            "ref": "#recurrenceRule",
            "type": "ref"
          },
          "maxLength": 1,
          "minLength": 1,
          "type": "array"
        },
        "showWithoutTime": {
          "type": "boolean"
        },
        "start": {
          "description": "Local date and time, YYYY-MM-DDTHH:mm:ss, interpreted in timeZone.",
          "type": "string"
        },
        "status": {
          "knownValues": [
            "confirmed",
            "cancelled"
          ],
          "type": "string"
        },
        "timeZone": {
          "type": "string"
        },
        "title": {
          "maxLength": 4096,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [],
      "type": "object"
    },
    "main": {
      "description": "ALPHA. Append-only proposed Calendar event edit. Host validates identity, permissions and causal history before accepting records.",
      "key": "any",
      "record": {
        "properties": {
          "payload": {
            "ref": "#payload",
            "type": "ref"
          }
        },
        "required": [
          "payload"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "participant": {
      "properties": {
        "did": {
          "format": "did",
          "type": "string"
        },
        "status": {
          "knownValues": [
            "accepted",
            "declined",
            "tentative"
          ],
          "type": "string"
        }
      },
      "required": [
        "did",
        "status"
      ],
      "type": "object"
    },
    "payload": {
      "properties": {
        "author": {
          "format": "did",
          "type": "string"
        },
        "base": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "eventId": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "id": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "patch": {
          "ref": "#eventPatch",
          "type": "ref"
        },
        "policy": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "recurrenceId": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "eventId",
        "base",
        "policy",
        "patch",
        "author"
      ],
      "type": "object"
    },
    "recurrenceRule": {
      "properties": {
        "count": {
          "maximum": 1000,
          "minimum": 1,
          "type": "integer"
        },
        "frequency": {
          "knownValues": [
            "daily",
            "weekly"
          ],
          "type": "string"
        },
        "interval": {
          "maximum": 52,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "frequency",
        "count"
      ],
      "type": "object"
    }
  },
  "id": "email.atmos.calendar.proposal",
  "lexicon": 1
}
```