Edit a note on a JSM alert
jsm_update_alert_noteCorrect an existing note on a JSM alert by replacing its text. Use it to fix mistakes such as a wrong hostname; for new developments, add a note instead.
Instructions
Replace the text of an existing note on a JSM alert.
Use it to correct a note you just wrote — a wrong hostname, a stale conclusion. Prefer adding a new note with jsm_add_alert_note for anything that reads as a development rather than a correction: the timeline is the record of what responders knew and when, and editing history out of it costs more than an extra line.
Args:
alert_id (string): the full alert id (not the tinyId)
note_id (string): id of the note to edit, from jsm_list_alert_notes
note (string): the replacement text
Returns the updated note: { "alert_id", "note_id", "note", "owner", "createdAt", "updatedAt" }
Unlike every other alert write, this one is synchronous. It answers with the note itself, so there is no requestId and nothing to verify with jsm_get_request_status.
This replaces the note's whole text. There is no append. Read the note first if you mean to add to it.
Examples:
"Fix my last note, the host is db-3 not db-2" -> jsm_list_alert_notes, take the id, then update with the corrected text
Constraints and errors:
HTTP 404 means the note id does not belong to that alert. Note ids come from jsm_list_alert_notes, not from the note's text.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | Note text to record on the alert's activity timeline. | |
| note_id | Yes | Id of the note to edit, from jsm_list_alert_notes. Not the note's text. | |
| alert_id | Yes | Full alert id, e.g. '9b251e07-73c9-4907-9996-8cb53a6a20d0-1704440650350'. This is NOT the short tinyId shown in the JSM UI — get the full id from jsm_list_alerts first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| note | No | ||
| owner | No | ||
| note_id | No | ||
| alert_id | Yes | ||
| createdAt | No | ||
| updatedAt | No |