Command
nylas calendar events update
Update an existing calendar event.
Written by Qasim Muhammad Staff SRE
What does nylas calendar events update do?
The nylas calendar events update command modifies an existing event on your connected calendar. Pass the event ID as a positional argument, then any combination of --title, --start, --end, or --location to change. Only the specified fields are updated; other fields remain unchanged. Works with Google Calendar, Outlook, Exchange, Yahoo, iCloud, and IMAP providers.
Usage
nylas calendar events update <event-id> [--title TITLE] [--start START] [--end END] [--location LOC]Flags
| Flag | Description |
|---|---|
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --title | New event title |
| --start | New start time (ISO 8601) |
| --end | New end time (ISO 8601) |
| --location | New event location |
| --all-day | Set as all-day event |
| --busy | Mark time as busy |
| --calendar(-c) | Calendar ID (defaults to primary) |
| --description(-D) | Event description |
| --free | Mark time as free (not busy) |
| --lock-timezone | Lock event to its timezone |
| --participant(-p) | Set participant emails (replaces existing) |
| --timezone | IANA timezone for start/end times (e.g., America/Los_Angeles). Defaults to system timezone. |
| --unlock-timezone | Remove timezone lock from event |
| --visibility | Event visibility (public, private, default) |
Examples
The nylas calendar events update command modifies an existing event on your connected calendar.
Change meeting time
nylas calendar events update abc123def456 --start 2026-03-30T14:00:00Z --end 2026-03-30T15:00:00ZAdd a participant to an existing event
nylas calendar events update abc123def456 --participant alice@example.com --participant bob@example.com --participant charlie@example.comExample output
✓ Event updated (evt_abc123)
Title: Sprint review (rescheduled)
When: 2026-07-01 15:00 - 16:00
Location: Conference Room ATroubleshooting
Update fails with 403
You can only update events you organize. If you're an attendee, you can change your RSVP status but not the event itself.
Participants not receiving update notification
Google Calendar sends update notifications automatically. Outlook may require the organizer to explicitly send updates via the web UI.
Recommended guides
Book meeting rooms from the CLI
Book meeting rooms from the CLI by listing calendar resources, using each room email as a calendar ID, and adding it as an event participant with less setup.
Google Calendar API Sync Tokens
Use Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.
Microsoft Graph calendarView Explained
Query the Microsoft Graph calendarView endpoint for events in a date range with recurrences expanded. Compare it to list events and read calendars from the CLI.
Microsoft Graph getSchedule Free/Busy
Call the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.
Google Workspace CLI: Limits and Alternative
What gws covers, where its OAuth scope limits and pre-1.0 status bite, and when a multi-provider email and calendar CLI is the better fit.
SavvyCal vs Nylas: Scheduling Compared
SavvyCal is a scheduling SaaS for end users. Nylas is the API and CLI for building scheduling into your product across Google, Microsoft, and iCloud calendars.
Run nylas calendar events update --help for full help output.