/calendars/{calendarId}
Returns a single calendar by id.
get
https://api.rest.rodeo/calendar/api/v1/calendars/{calendarId}
Path Parameters
calendarIdstring(uuid)required
The calendar id.
Response
application/json
Response
application/json
The calendar
Calendar
* Additional properties are NOT allowed.
idstring(uuid)required
The calendar id.
namestringrequired
The calendar name.
<= 256 characters
get/calendars/{calendarId}
Authentication
Path Parameters
application/json
/calendars/{calendarId}
Replaces the calendar’s name.
put
https://api.rest.rodeo/calendar/api/v1/calendars/{calendarId}
Path Parameters
calendarIdstring(uuid)required
The calendar id.
Body
application/json
Body
application/json
CalendarRequest
* Additional properties are NOT allowed.
namestringrequired
The calendar name.
>= 1 characters<= 256 characters
Response
application/json
Response
application/json
The updated calendar
Calendar
* Additional properties are NOT allowed.
idstring(uuid)required
The calendar id.
namestringrequired
The calendar name.
<= 256 characters
put/calendars/{calendarId}
Authentication
Path Parameters
Body
{
"name": "Personal"
}
application/json
/calendars/{calendarId}
Deletes the calendar and all of its events.
delete
https://api.rest.rodeo/calendar/api/v1/calendars/{calendarId}
Path Parameters
calendarIdstring(uuid)required
The calendar id.
Response
Response
The calendar was deleted
delete/calendars/{calendarId}
Authentication
Path Parameters
/calendars/{calendarId}/events
Lists every event in the calendar.
get
https://api.rest.rodeo/calendar/api/v1/calendars/{calendarId}/events
Path Parameters
calendarIdstring(uuid)required
The calendar id.
Response
application/json
Response
application/json
All events in the calendar
EventsList
* Additional properties are NOT allowed.
eventsarray[object]required
* Additional properties are NOT allowed.
Show Child Parameters
get/calendars/{calendarId}/events
Authentication
Path Parameters
application/json
/calendars/{calendarId}/events
Creates an event in the calendar. When allDay is true, startTime and endTime must be null; otherwise both are required.
post
https://api.rest.rodeo/calendar/api/v1/calendars/{calendarId}/events
Path Parameters
calendarIdstring(uuid)required
The calendar id.
Body
application/json
Body
application/json
EventRequest
* Additional properties are NOT allowed.
titlestringrequired
The event title.
>= 1 characters<= 256 characters
descriptionstringrequired
The event description.
<= 2000 characters
startDatestringrequired
The date the event starts.
Match pattern:^\d{4}-\d{2}-\d{2}$
Example:2026-10-01
endDatestringrequired
The date the event ends. Must not be before startDate.
Match pattern:^\d{4}-\d{2}-\d{2}$
Example:2026-10-01
startTimestring | nullrequired
The time the event starts. Required null when allDay is true, required non-null otherwise.
Match pattern:^([01]\d|2[0-3]):[0-5]\d$
Example:18:00
endTimestring | nullrequired
The time the event ends. Required null when allDay is true, required non-null otherwise.
Match pattern:^([01]\d|2[0-3]):[0-5]\d$
Example:21:00
allDaybooleanrequired
Whether the event lasts all day.
Response
application/json
Response
application/json
The created event
Event
* Additional properties are NOT allowed.
idstring(uuid)required
The event id.
calendarIdstring(uuid)required
The id of the calendar this event belongs to.
titlestringrequired
The event title.
<= 256 characters
descriptionstringrequired
The event description.
<= 2000 characters
startDatestringrequired
The date the event starts.
Match pattern:^\d{4}-\d{2}-\d{2}$
Example:2026-10-01
endDatestringrequired
The date the event ends. Must not be before startDate.
Match pattern:^\d{4}-\d{2}-\d{2}$
Example:2026-10-01
startTimestring | nullrequired
The time the event starts. Null when allDay is true.
Match pattern:^([01]\d|2[0-3]):[0-5]\d$
Example:18:00
endTimestring | nullrequired
The time the event ends. Null when allDay is true.
Match pattern:^([01]\d|2[0-3]):[0-5]\d$
Example:21:00
allDaybooleanrequired
Whether the event lasts all day. When true, startTime and endTime must be null; otherwise both are required.
post/calendars/{calendarId}/events
Authentication
Path Parameters
Body
{
"title": "Rodeo kickoff",
"description": "Season opener",
"startDate": "2026-10-01",
"endDate": "2026-10-01",
"startTime": "18:00",
"endTime": "21:00",
"allDay": false
}
application/json