Participation Status
Description #
Changes the status of a user’s participation in an event.
In order for this to be possible, you must request the change_participation_status scope when requesting authorization to access the user’s calendars.
If an invite is declined in Office 365 or Exchange the event is implicitly deleted in the calendar and so will not be able to be modified again.
URL format #
api.cronofy.com/v1/calendars/{calendar_id}/events/{event_uid}/participation_status
Example Request #
POST /v1/calendars/{calendar_id}/events/{event_uid}/participation_status HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8
{
"status": "accepted"
}Example Response #
HTTP/1.1 202 AcceptedRequest parameters #
calendar_id required #
The calendar_id of the calendar that contains the event for which you’d like to update the participation status. This ID can be retrieved using a list calendars request
This calendar must not have a calendar_readonly value that is true.
event_uid required #
The String that uniquely identifies the event. This ID can be retrieved using the read events request.
This event must be have its options.change_participation_status flag set to true.
status required #
A String representing the participation status you’d like to set. Acceptable values are:
accepted- to accept the invitetentative- to tentatively accept the invitedeclined- to decline the invite