Event

This entity represents an event.

Properties

Property	Type (Length)	Editable	Description
`author`	diaspora* ID	✘	The diaspora* ID of the author of the event.
`guid`	GUID	✘	The GUID of the event.
`summary`	String (255)	✔	The summary of the event.
`start`	Timestamp	✔	The start time of the event (in UTC).

Optional Properties

Property	Type (Length)	Editable	Description
`end`	Timestamp	✔	The end time of the event (in UTC). If missing it is an open-end or a single `all_day` event.
`all_day`	Boolean	✔	`true` if it is an all day event. Time/timezone is ignored. `false` by default.
`timezone`	Timezone	✔	If the event is fixed to a specific timezone, this can be set. The `start`/`end` timestamps are then displayed in this timezone. This is useful for local events. If missing or empty the timestamps are displayed in the timezone of the user.
`description`	Markdown (65535)	✔	Description of the event.
`location`	Location	✔	Location of the event.
`edited_at`	Timestamp	✔	The timestamp when the event was edited.

Examples

With start, end and timezone

<event>
  <author>alice@example.org</author>
  <guid>bb8371f0b1c901342ebd55853a9b5d75</guid>
  <summary>Cool event</summary>
  <start>2016-12-27T12:00:00Z</start>
  <end>2016-12-27T13:00:00Z</end>
  <all_day>false</all_day>
  <timezone>Europe/Berlin</timezone>
  <description>You need to see this!</description>
  <location>
    <address>Vienna, Austria</address>
    <lat>48.208174</lat>
    <lng>16.373819</lng>
  </location>
</event>

All day event

<event>
  <author>alice@example.org</author>
  <guid>bb8371f0b1c901342ebd55853a9b5d75</guid>
  <summary>Cool event</summary>
  <start>2016-12-27T00:00:00Z</start>
  <end/>
  <all_day>true</all_day>
  <timezone/>
  <description>You need to see this!</description>
  <location>
    <address>Vienna, Austria</address>
    <lat>48.208174</lat>
    <lng>16.373819</lng>
  </location>
</event>