events

3 endpoints at a glance

Method	Path	Summary
GET	/events	List Events
GET	/events/{calendar_id}/{uid}	Get Event
POST	/events/{calendar_id}/{uid}/sync	Sync Event

events

---

List Events

GET

/events

List the current user's events.

date_from / date_to are ISO 8601 strings. Cross-calendar by
default (decision (4)); pass calendar_id to filter to one.
include_recurring also returns recurring masters that began before
date_to (the calendar week/month views expand them client-side).

Parameters

Header Parameters

authorization

Query Parameters

calendar_id

kind

q

date_from

date_to

include_recurring

Type

boolean

Default

false

page

Type

integer

Default

1

limit

Type

integer

Default

50

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/events

Playground

Headers

authorization

Variables

Key

Value

calendar_id

kind

q

date_from

date_to

include_recurring

page

limit

Samples

---

Get Event

GET

/events/{calendar_id}/{uid}

One event, full payload (parsed + raw iCal).

Parameters

Header Parameters

authorization

Path Parameters

calendar_id*

Type

string

Required

uid*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/events/{calendar_id}/{uid}

Playground

Headers

authorization

Variables

Key

Value

calendar_id*

uid*

Samples

---

Sync Event

POST

/events/{calendar_id}/{uid}/sync

Re-fetch this event from the CalDAV server.

Parameters

Header Parameters

authorization

Path Parameters

calendar_id*

Type

string

Required

uid*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/events/{calendar_id}/{uid}/sync

Playground

Headers

authorization

Variables

Key

Value

calendar_id*

uid*

Samples

---