PUT https://app.alaaqat.com/api/invoices/{invoice_id}/notes/{note_id}
Where invoice_id is the invoice's _id and note_id is the note's _id. Replaces the text of a note. Your API key needs the invoice-note-update ability, and the team member who created the key needs Edit Invoice Notes.
The note then shows that team member as its author in made_by.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
| Field | Required | Validation | Description |
|---|---|---|---|
| description | Required | Text | The new text of the note. |
{
"description": "The client will pay the remaining balance by bank transfer at the end of the month. Done."
}
200 OK, with the updated note under data.
{
"data": {
"_id": "6658d1e2f3a4b5c6d7e8f901",
"description": "The client will pay the remaining balance by bank transfer at the end of the month. Done.",
"invoice_id": "6657c1d2e3f4a5b6c7d8e901",
"made_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"message": "Entity was modified successfully."
}
| Status | Meaning |
|---|---|
| 404 | No note with this _id on this invoice. |
| 422 | description is missing or isn't text. |