Source: https://cli.nylas.com/docs/commands/calendar-events-update

# nylas calendar events update

Update an existing calendar event.

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## 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

```bash
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

```bash
nylas calendar events update abc123def456 --start 2026-03-30T14:00:00Z --end 2026-03-30T15:00:00Z
```

### Add a participant to an existing event

```bash
nylas calendar events update abc123def456 --participant alice@example.com --participant bob@example.com --participant charlie@example.com
```

## Example output

```text
✓ Event updated (evt_abc123)
  Title:    Sprint review (rescheduled)
  When:     2026-07-01 15:00 - 16:00
  Location: Conference Room A
```

## Troubleshooting

### 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.

## Related commands

[nylas calendar ai analyzeAnalyze meeting patterns and get AI recommendations.](https://cli.nylas.com/docs/commands/calendar-ai-analyze)

[nylas calendar ai conflicts checkCheck a proposed meeting for scheduling conflicts with AI analysis.](https://cli.nylas.com/docs/commands/calendar-ai-conflicts-check)

[nylas calendar ai reschedule aiAI-powered meeting rescheduling with alternative suggestions.](https://cli.nylas.com/docs/commands/calendar-ai-reschedule-ai)

[nylas calendar availability checkCheck participant availability for a time window.](https://cli.nylas.com/docs/commands/calendar-availability-check)

[nylas calendar events createCreate a new calendar event with participants, location, and description.](https://cli.nylas.com/docs/commands/calendar-events-create)

[nylas calendar events deleteDelete a calendar event by ID.](https://cli.nylas.com/docs/commands/calendar-events-delete)

## Recommended guides

[Book meeting rooms from the CLIBook 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.](https://cli.nylas.com/guides/book-meeting-rooms-cli)

[Google Calendar API Sync TokensUse Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.](https://cli.nylas.com/guides/google-calendar-api-sync-tokens)

[Microsoft Graph calendarView ExplainedQuery 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.](https://cli.nylas.com/guides/microsoft-graph-calendar-view)

[Microsoft Graph getSchedule Free/BusyCall the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.](https://cli.nylas.com/guides/microsoft-graph-get-schedule)

[Google Workspace CLI: Limits and AlternativeWhat 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.](https://cli.nylas.com/guides/google-workspace-cli-alternative)

[SavvyCal vs Nylas: Scheduling ComparedSavvyCal 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.](https://cli.nylas.com/guides/savvycal-vs-nylas)

Run `nylas calendar events update --help` for full help output.