---
title: "Update a specific note"
description: "PUT /notes/{note_id} — Updates a note. The author display name stays with the original author."
canonical_url: https://developer.onepagecrm.com/api/reference/notes/put-notes-note_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/notes/put-notes-note_id/
---

`PUT /notes/{note_id}`

Updates a note. The author display name stays with the original author.

Resource: [Notes](https://developer.onepagecrm.com/api/reference/notes/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X PUT "https://app.onepagecrm.com/api/v3/notes/{note_id}" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "5ae06ef9d55673108fe8877f",
    "text": "I met Jane Doe at the ABC conference. She's interested in hearing about XYZ.",
    "date": "2018-05-16",
    "linked_deal_id": "",
    "user_ids_to_notify": [
      "5aba31e99007ba0f570c12f7"
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `note_id` | string | Note ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `contact_id` | string (bson-id) |  | ID of the contact, to whom the note belongs |
| `text` | string |  | Extra details related to the note(supports `[b]bold[/b]` and `[i]italic[/i]` formatting) |
| `date` | string (date) |  | Creation date of the note. Defaults to today's date. |
| `linked_deal_id` | string (bson-id) |  |  |
| `user_ids_to_notify` | array<string (bson-id)> |  | A list of user IDs to notify |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "note": {
      "id": "5afc1b69d556730b580596cb",
      "contact_id": "5ae06ef9d55673108fe8877f",
      "text": "I met Jane Doe at the ABC conference. She's interested in hearing about XYZ.",
      "date": "2018-05-16",
      "linked_deal_id": "",
      "linked_deal_name": "",
      "author": "Jane D.",
      "attachments": [
        {
          "id": "5afc1ea9d556730b780096db",
          "filename": "mario.jpg",
          "custom_filename": "another_mario.jpg",
          "pinned": true,
          "pinned_at": "2022-01-24T10:42:39Z",
          "size": 3841,
          "storage_provider": "amazon",
          "url": "https://{foo.bar}/mario.jpg",
          "url_expires_at": "2018-05-16T13:06:53Z",
          "thumbnail": {
            "url": "https://{foo.bar}/mario-thumbnail.jpg"
          }
        }
      ],
      "created_at": "2018-05-16T11:52:09Z",
      "modified_at": "2018-05-16T11:52:09Z"
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Partial updates](https://developer.onepagecrm.com/api/partial-updates/)