Delete an appointment

.md

Take away one appearance, the rest of a series, or the whole thing.

Scopescalendar:write
DELETE/v1/me/calendar/events/{id}

The guests and the reminders go with whatever this removes.

Deleting a whole appointment that has guests sends them a cancellation, so their own calendar marks it off rather than leaving a meeting nobody attends. Removing one appearance of a series does not: that is a change to the series, not a cancellation of it.

Request

ParameterDescription
occurrence_startWhich appearance, as the moment the rule originally put it
scopethis, following or all. Defaults to this
curl -X DELETE "https://api.proppertrading.com/v1/me/calendar/events/evt_k7m2p9x4q8r3t6v5?occurrence_start=2026-08-24T07:00:00Z&scope=following" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"

Response

204, with no body.

Errors

StatusCodeMeaning
403insufficient_scopeThis device does not hold calendar:write
403calendar_read_onlyThe account may read that calendar but not write in it, or it is a followed calendar, which nobody writes in
404resource_not_foundNo such appointment here