---
title: "Event"
url: "https://developers.rest.rodeo/apis/calendar/versions/9fa518e1-4597-4801-ad08-2c360cda2316/schemas/Event"
---

> Full API specification: https://developers.rest.rodeo/apis/calendar/versions/9fa518e1-4597-4801-ad08-2c360cda2316.md

# Event

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Calendar API
  version: 1.0.0
servers:
  - url: https://api.rest.rodeo/calendar/api/v1
    description: Production
components:
  schemas:
    Event:
      type: object
      required:
        - id
        - calendarId
        - title
        - description
        - startDate
        - endDate
        - startTime
        - endTime
        - allDay
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
          description: The event id.
        calendarId:
          type: string
          format: uuid
          description: The id of the calendar this event belongs to.
        title:
          type: string
          description: The event title.
          maxLength: 256
        description:
          type: string
          description: The event description.
          maxLength: 2000
        startDate:
          type: string
          description: The date the event starts.
          pattern: ^\d{4}-\d{2}-\d{2}$
          example: 2026-10-01
        endDate:
          type: string
          description: The date the event ends. Must not be before `startDate`.
          pattern: ^\d{4}-\d{2}-\d{2}$
          example: 2026-10-01
        startTime:
          type: string
          nullable: true
          description: The time the event starts. Null when `allDay` is true.
          pattern: ^([01]\d|2[0-3]):[0-5]\d$
          example: 18:00
        endTime:
          type: string
          nullable: true
          description: The time the event ends. Null when `allDay` is true.
          pattern: ^([01]\d|2[0-3]):[0-5]\d$
          example: 21:00
        allDay:
          type: boolean
          description: Whether the event lasts all day. When true, `startTime` and
            `endTime` must be null; otherwise both are required.
```