add_or_update_note
Destructive
Add or edit a plain text note (category NOTE) on the Intervals.icu calendar. Update only note events with partial changes, duplicate checks, and dry-run previews.
Instructions
Use only when the athlete asks to add or edit a plain text note (category NOTE) on the Intervals.icu calendar. Writes to Intervals.icu.
Updates are partial: only the passed fields change (renaming keeps text, colour and date); an empty description never wipes the text, clear_description=true does. Only notes can be updated: anything else (a workout, a race) is refused, never turned into a note. A duplicate of that day is refused (allow_duplicate); dry_run shows the request; the answer reads back what was stored.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Note title; required when creating | |
| color | No | Colour name, e.g. green, orange, red, blue; default green when creating | |
| dry_run | No | true = check and return the exact request, write nothing | |
| event_id | No | NOTE event to update; omit to create | |
| athlete_id | No | Default: the configured athlete | |
| start_date | No | Day YYYY-MM-DD; default today when creating, unchanged when updating | |
| description | No | Plain text of the note; replaces the text on update (empty is ignored) | |
| allow_duplicate | No | Create even if that day has the same event (name or workout) | |
| clear_description | No | Empty the note's text on update |