Edit External Events
Description #
Allows the editing of external events, ie those not created through the Cronofy API connection.
See Create or Update Event for details of all possible parameters.
In order to make this call, you must request elevated access to access the user’s calendars. Then, the event itself must be have its options.update
flag set to true
.
This endpoint is the same as for managed events, however rather than specifying an event_id
you will instead use the event_uid
of the externally created event:
URL format #
api.cronofy.com/v1/calendars/{calendar_id}/events
Example Request #
POST /v1/calendars/cal_n23kjnwrw2_jsdfjksn234/events HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8
{
"event_uid": "evt_external_54008b1a4a41730f8d5c6037",
"summary": "Board meeting",
"description": "Discuss plans for the next quarter.",
"start": "2014-08-05T15:30:00Z",
"end": "2014-08-05T17:00:00Z",
"location": {
"description": "Board room"
}
}
When editing an externally created event the behavior is a little different to a partner event. Namely it is no longer an “upsert” so once the event is deleted you cannot recreate it. If you want to recreate an event we suggest that you instead create a fully managed event in its place.
Caveats #
Recurring events
Recurring events are not editable. In order to know if an event can be deleted or updated the options attribute can be inspected when making a Read Events request.
Recurring events can also be identified by the recurring
Boolean attribute on events when making a Read Events request.