Oko
Oko/Docs

Command reference

oko calendar edit

Changes named fields of one existing event; untouched fields stay as the provider has them.

Invocation#

Command
oko calendar edit --account ID --event EVENT-ID [--title T] [--starts ISO] [--ends ISO] [--location L] [--notes N]

Inputs and options#

  • --event is the id calendar list shows; at least one field flag is required.

Output and state effect#

  • CalDAV performs a read-modify-write of the event's own resource; Google and Microsoft PATCH and the returned resource becomes the mirrored record; EventKit saves the changed event.

Refusals and safe exits#

  • With no field flags it refuses: calendar edit changes nothing without at least one of --title, --starts, --ends, --location, --notes.
  • With both --starts and --ends, an end at or before the start refuses with the same sentence as add, naming calendar edit.
  • A missing event refuses: no event '…' exists on account '…'; run 'oko calendar sync' and 'oko calendar list' to see current events.
  • ICS accounts and the ungrated EventKit consent refuse with their exact sentences.

CLI reference#