Skip to Content
CallMitraDocs
API referenceLead notes

Edit a note

Send the `version` you read. If someone changed the note since, you get 409 `lead_note_changed` with the current note in `detail.note`. Only the author or a workspace manager can edit a person's note.

PATCH
/api/v1/leads/{lead_id}/notes/{note_id}

Send the version you read. If someone changed the note since, you get 409 lead_note_changed with the current note in detail.note. Only the author or a workspace manager can edit a person's note.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

lead_id*Lead Id

Lead ID.

note_id*Note Id

Note ID, from GET /leads/{leadId}/notes.

Request Body

application/json
  1. body

New text for a note.

body*Body

Note text, up to 10000 characters.

Length1 <= length <= 10000
version*Version

The note's version when you read it.

Range1 <= value

Response Body

OK

application/json
  1. response

The note after the change.

note?|

The note.

notesCount?|

Live notes on the lead (on create).

success?|

Always true.

[key: string]?any
Example Request
curl -X PATCH 'https://api.callmitra.ai/api/v1/leads/string/notes/string' \  -H 'Content-Type: application/json' \  -d '{  "body": "Call back after 6pm on weekdays.",  "version": 1}'
Example Response
{  "note": {    "authorKind": "api",    "body": "Call back after 6pm on weekdays.",    "createdAt": "2026-05-04T10:15:00Z",    "editedAt": "2026-05-04T11:00:00Z",    "id": "8a1f3c2e-5b7d-4e0a-9c61-2d4b8e7f0a13",    "kind": "note",    "leadId": "3f2c9d6e-1a4b-4c8d-9e0f-7a6b5c4d3e21",    "pinned": false,    "updatedAt": "2026-05-04T11:00:00Z",    "version": 2  },  "success": true}