PUT https://app.alaaqat.com/api/companies/{company_id}/notes/{note_id}
Where company_id is the company's _id and note_id is the note's _id. Replaces the text of a note. Your API key needs the company-note-update ability, and the team member who created the key needs Edit Note on Company.
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": "Called to confirm the yearly renewal. Procurement asked for the updated price list. Price list sent."
}
200 OK, with the updated note under data.
{
"data": {
"_id": "6658d1e2f3a4b5c6d7e8f901",
"description": "Called to confirm the yearly renewal. Procurement asked for the updated price list. Price list sent.",
"company_id": "6655a1b2c3d4e5f6a7b8c901",
"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 company. |
| 422 | description is missing or isn't text. |