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.
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 Accepted
Request 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