Reschedule an event
const url = 'https://calendar.work.optidata.cloud/api/events/4167/reschedule';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"inv_id":"4167-4166","datetime_start":"2026-08-24 15:00:00","datetime_end":"2026-08-24 16:00:00","is_all_day":false}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://calendar.work.optidata.cloud/api/events/4167/reschedule \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "inv_id": "4167-4166", "datetime_start": "2026-08-24 15:00:00", "datetime_end": "2026-08-24 16:00:00", "is_all_day": false }'Moves an event to a new start and end without restating the rest of it — the drag-and-drop of the API. Everything else about the event is left alone, and the attendees are told it moved.
Only the organizer can reschedule, and only with write access to the
calendar. Pass recurrence_id to move a single occurrence of a recurring
event; that occurrence then becomes an exception to the series.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Id of the event, as returned in an event’s id.
Request Bodyrequired
Section titled “Request Bodyrequired”New bounds for an event or one of its occurrences.
object
Invitation id, from the event record you read.
Start of the occurrence to move. Omit to move a one-off event or a whole series.
Examples
Move a one-off event one hour later
{ "inv_id": "4167-4166", "datetime_start": "2026-08-24 15:00:00", "datetime_end": "2026-08-24 16:00:00", "is_all_day": false}Responses
Section titled “ Responses ”The rescheduled event.
object
An event and its occurrences. The event itself carries the identifiers;
everything about the schedule lives in instances.
object
ICalendar UID. Unlike id, it survives the event being copied between
calendars.
Calendar the event lives in.
Invitation id. Part of the concurrency triple you send back on an update.
Modification sequence. Send it back unchanged on an update.
Revision. Send it back unchanged on an update.
One occurrence of an event. A one-off event has exactly one; a recurring event has one per occurrence inside the window you asked for.
object
Invitation id. Send it back when updating or rescheduling.
CONF confirmed, TENT tentative, CANC cancelled, NEED awaiting
an answer.
Start of this occurrence, for a recurring event.
Title of the event.
true when the caller owns the event.
true when this occurrence was detached from its series.
Filled in on a single-event read; on a list, only when
include_description was requested.
Who owns the event.
Time zone the event was created in, when it differs.
Somebody invited to the event.
object
A reminder, expressed as an offset from the event. isNegative: true means
the reminder fires before the moment named by related; the unit fields
that do not apply are 0 or null.
object
Whether the offset is measured from the start or the end.
Who takes part in one occurrence, summarized for an event card. Present
only on a list (GET /events) called with
include_participants_summary=true; absent otherwise.
The participants are listed as the event details show them: the organizer first, when the occurrence has one, then the attendees in invitation order. The organizer is not looked up among the attendees, so an organizer who is also listed as an attendee counts twice. An exception occurrence is summarized from its own participants.
Even with the flag on, an occurrence can lack participantsSummary
when its participants could not be read, for instance when the event
was deleted while the list was being built. Read a missing
participantsSummary as unknown, not as zero participants.
object
Number of participants of the occurrence: the organizer, when there
is one, plus every attendee. 0 when it has none.
The first three participants, in the order above. Empty when the occurrence has none.
object
The participant’s name or, when it has none, their email
address. null when both are missing.
The participant’s avatar, or null when there is none.
Example
{ "event": { "id": "4167", "calendarId": "10", "instances": [ { "status": "CONF", "organizer": { "type": "user" }, "recurrenceRule": { "frequency": "DAILY" }, "userParticipationStatus": "NEEDS-ACTION", "attendees": [ { "type": "user", "participationStatus": "NEEDS-ACTION" } ], "alarms": [ { "related": "START" } ], "participantsSummary": { "participantsCount": 5, "participants": [ { "name": "Jane Doe" } ] } } ] }}Missing, malformed or expired authentication key.
Authentication failures use an error key rather than message.
object
Examples
No bearer token sent
{ "error": "JWT passport exception: Missing bearer token in request"}The caller is not the organizer of the event, or lacks write access to the calendar it lives in.
Failures raised by the calendar layer itself — a permission refusal, or a
calendar or event that cannot be read. help is a hint for the end user
and is often empty.
object
What went wrong.
Repeats the HTTP status code.
Suggested next step, or an empty string.
Examples
{ "error": "Only the event organizer can change this event.", "status": 403, "help": "Ask the organizer to make this change for you."}The request body or query string failed validation.
object
The first validation message.
Validation messages keyed by field name.
object
Examples
{ "message": "The event title field is required.", "errors": { "title": [ "The event title field is required." ] }}Rate limit exceeded. Retry after the window resets.
Generic error envelope used by policy, binding and framework failures.
object
Human-readable description of the failure.
Examples
{ "message": "Too Many Attempts."}