Add a note
Write a note on a service record, internal by default.
POST https://cotlet.dev/api/v1/sysaid/records/{record_id}/notes
write Confirm
Returns the note ID and whether it is internal or shared. Notes can notify users and groups your admin set up for "Notes are added", and an @mention in the text emails the person named. A shared note reaches the requester. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| record_id integer required | integer | Service record ID from search_service_records. IDs are unique across incidents, requests, problems and changes. |
| body string required | string | Text of the note, 5,000 characters at most, no emojis. |
| share_with_requester boolean | boolean | true shows the note to the request user. A shared note cannot be made internal again. Default false. |
Request
curl -X POST https://cotlet.dev/api/v1/sysaid/records/48230/notes \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"Gateway session timeout is 60 minutes, matching the reported drops. Network group to raise it.","share_with_requester":false}'result = client.call("sysaid", "add_note", {"record_id":48230,"body":"Gateway session timeout is 60 minutes, matching the reported drops. Network group to raise it.","share_with_requester":False})const result = await cotlet.call('sysaid', 'add_note', {"record_id":48230,"body":"Gateway session timeout is 60 minutes, matching the reported drops. Network group to raise it.","share_with_requester":false});cotlet call sysaid add_note --data '{"record_id":48230,"body":"Gateway session timeout is 60 minutes, matching the reported drops. Network group to raise it.","share_with_requester":false}'Example response
{
"note_id": 9140,
"record_id": 48230,
"visibility": "internal",
"created_at": "2026-10-23T08:43:00Z"
}