---
title: "Update calendar event"
method: PUT
path: "/v1/calendar-events/{id}"
tags: ["Calendar Events"]
---

# Update calendar event

`PUT /v1/calendar-events/{id}`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/calendar-events/{id}`
- Auth: HTTP basic

Update a specific calendar event. You can modify the iCalendar data or move the event to a different calendar.

## Request body

- CalendarEventUpdateInput
  - `calendar_id` string: Move event to a different calendar
  - `ical` string: Updated iCalendar (RFC 5545) data for the event

## Response `200`

Calendar event updated successfully

- CalendarEvent
  - `id` string, required: Calendar event ID (eventId from CalDAV)
  - `calendar_id` string, required: ID of the calendar this event belongs to
  - `ical` string, required: iCalendar (RFC 5545) data for the event
  - `summary` string: Event title/summary (extracted from iCal data)
  - `description` string: Event description (extracted from iCal data)
  - `location` string: Event location (extracted from iCal data)
  - `start_date` string, date-time: Event start date/time (extracted from iCal data)
  - `end_date` string, date-time: Event end date/time (extracted from iCal data)
  - `uid` string: Unique identifier from iCal data
  - `status` string: Event status (extracted from iCal data)
  - `organizer` string: Event organizer (extracted from iCal data)
  - `deleted_at` string, date-time, nullable: Soft deletion timestamp
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `object` 'calendar_event', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)