# social.craftsky.business.event

> Published by [craftsky.social](https://lexicon.garden/identity/did:plc:lmmx63zcns6gewgxqfdt4kof)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:lmmx63zcns6gewgxqfdt4kof/social.craftsky.business.event)
- [Documentation](https://lexicon.garden/lexicon/did:plc:lmmx63zcns6gewgxqfdt4kof/social.craftsky.business.event/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:lmmx63zcns6gewgxqfdt4kof/social.craftsky.business.event/examples)

## Definitions

### `social.craftsky.business.event`

**Type**: `record`

An independently addressable public event appearance for a Craftsky business.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes | Record creation timestamp. Craftsky server-stamps and preserves this value. |
| `endsAt` | `string` (datetime) | Yes | Exclusive event end instant for all-day events and end instant otherwise. |
| `eventUri` | `string` (uri) | No | Optional external event information destination. |
| `image` | `ref` → `social.craftsky.business.defs#image` | No | Optional event image. |
| `isAllDay` | `boolean` | No | True when start and exclusive end represent local-midnight all-day boundaries; omitted means false. |
| `mode` | `string` | No | Open event attendance mode. |
| `name` | `string` | Yes | Public event name. |
| `registrationUri` | `string` (uri) | No | Optional external registration destination. |
| `roles` | `array` | Yes | Open set of the business's roles at the event. |
| `startsAt` | `string` (datetime) | Yes | Inclusive event start instant. |
| `status` | `string` | No | Open authored lifecycle status; completion is derived from endsAt. |
| `summary` | `string` | No | Optional summary of the business's public appearance. |
| `timeZone` | `string` | No | IANA timezone name used to interpret all-day boundaries. |
| `venueName` | `string` | No | Optional display-only venue name. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "An independently addressable public event appearance for a Craftsky business.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "description": "Record creation timestamp. Craftsky server-stamps and preserves this value.",
            "format": "datetime",
            "type": "string"
          },
          "endsAt": {
            "description": "Exclusive event end instant for all-day events and end instant otherwise.",
            "format": "datetime",
            "type": "string"
          },
          "eventUri": {
            "description": "Optional external event information destination.",
            "format": "uri",
            "type": "string"
          },
          "image": {
            "description": "Optional event image.",
            "ref": "social.craftsky.business.defs#image",
            "type": "ref"
          },
          "isAllDay": {
            "description": "True when start and exclusive end represent local-midnight all-day boundaries; omitted means false.",
            "type": "boolean"
          },
          "mode": {
            "description": "Open event attendance mode.",
            "knownValues": [
              "in-person",
              "online",
              "hybrid"
            ],
            "maxLength": 64,
            "type": "string"
          },
          "name": {
            "description": "Public event name.",
            "maxGraphemes": 200,
            "maxLength": 2000,
            "type": "string"
          },
          "registrationUri": {
            "description": "Optional external registration destination.",
            "format": "uri",
            "type": "string"
          },
          "roles": {
            "description": "Open set of the business's roles at the event.",
            "items": {
              "knownValues": [
                "organizer",
                "instructor",
                "vendor",
                "exhibitor",
                "speaker",
                "demonstrator"
              ],
              "maxLength": 64,
              "type": "string"
            },
            "maxLength": 10,
            "minLength": 1,
            "type": "array"
          },
          "startsAt": {
            "description": "Inclusive event start instant.",
            "format": "datetime",
            "type": "string"
          },
          "status": {
            "description": "Open authored lifecycle status; completion is derived from endsAt.",
            "knownValues": [
              "scheduled",
              "cancelled",
              "postponed"
            ],
            "maxLength": 64,
            "type": "string"
          },
          "summary": {
            "description": "Optional summary of the business's public appearance.",
            "maxGraphemes": 1000,
            "maxLength": 10000,
            "type": "string"
          },
          "timeZone": {
            "description": "IANA timezone name used to interpret all-day boundaries.",
            "maxLength": 256,
            "type": "string"
          },
          "venueName": {
            "description": "Optional display-only venue name.",
            "maxGraphemes": 200,
            "maxLength": 2000,
            "type": "string"
          }
        },
        "required": [
          "name",
          "startsAt",
          "endsAt",
          "roles",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "social.craftsky.business.event",
  "lexicon": 1
}
```