---
title: "Update a note"
method: PUT
path: "/notes/{id}"
tags: ["Notes"]
---

# Update a note

`PUT /notes/{id}`

Updates a note.

## Path parameters

- `id` integer, required

## Request body

- object
  - `content` string — The content of the note in HTML format. Subject to sanitization on the back-end.
  - `lead_id` string, uuid — The ID of the lead the note will be attached to
  - `deal_id` integer — The ID of the deal the note will be attached to
  - `person_id` integer — The ID of the person the note will be attached to
  - `org_id` integer — The ID of the organization the note will be attached to
  - `project_id` integer — The ID of the project the note will be attached to
  - `task_id` integer — The ID of the task the note will be attached to
  - `user_id` integer — The ID of the user who will be marked as the author of the note. Only an admin can change the author.
  - `add_time` string — The optional creation date & time of the note in UTC. Can be set in the past or in the future. Format: YYYY-MM-DD HH:MM:SS
  - `pinned_to_lead_flag` 0 | 1 — If set, the results are filtered by note to lead pinning state (`lead_id` is also required)
  - `pinned_to_deal_flag` 0 | 1 — If set, the results are filtered by note to deal pinning state (`deal_id` is also required)
  - `pinned_to_organization_flag` 0 | 1 — If set, the results are filtered by note to organization pinning state (`org_id` is also required)
  - `pinned_to_person_flag` 0 | 1 — If set, the results are filtered by note to person pinning state (`person_id` is also required)
  - `pinned_to_project_flag` 0 | 1 — If set, the results are filtered by note to project pinning state (`project_id` is also required)
  - `pinned_to_task_flag` 0 | 1 — If set, the results are filtered by note to task pinning state (`task_id` is also required)

## Response `200`

Add, update or get a note

- object
  - `success` boolean — If the request was successful or not
  - `data` object
    - `id` integer — The ID of the note
    - `active_flag` boolean — Whether the note is active or deleted
    - `add_time` string — The creation date and time of the note
    - `content` string — The content of the note in HTML format. Subject to sanitization on the back-end.
    - `deal` object — The deal this note is attached to
      - `title` string — The title of the deal this note is attached to
    - `lead_id` string, uuid — The ID of the lead the note is attached to
    - `deal_id` integer — The ID of the deal the note is attached to
    - `last_update_user_id` integer — The ID of the user who last updated the note
    - `org_id` integer — The ID of the organization the note is attached to
    - `organization` object — The organization the note is attached to
      - `name` string — The name of the organization the note is attached to
    - `person` object — The person the note is attached to
      - `name` string — The name of the person the note is attached to
    - `person_id` integer — The ID of the person the note is attached to
    - `project_id` integer — The ID of the project the note is attached to
    - `project` object — The project the note is attached to
      - `title` string — The title of the project the note is attached to
    - `task_id` integer — The ID of the task the note is attached to
    - `task` object — The task the note is attached to
      - `title` string — The title of the task the note is attached to
    - `pinned_to_deal_flag` boolean — If true, the results are filtered by note to deal pinning state
    - `pinned_to_organization_flag` boolean — If true, the results are filtered by note to organization pinning state
    - `pinned_to_person_flag` boolean — If true, the results are filtered by note to person pinning state
    - `pinned_to_project_flag` boolean — If true, the results are filtered by note to project pinning state
    - `pinned_to_task_flag` boolean — If true, the results are filtered by note to task pinning state
    - `update_time` string — The last updated date and time of the note
    - `user` object — The user who created the note
      - `email` string — The email of the note creator
      - `icon_url` string — The URL of the note creator avatar picture
      - `is_you` boolean — Whether the note is created by you or not
      - `name` string — The name of the note creator
    - `user_id` integer — The ID of the note creator

---

[API](https://skmtc.net/pipedrive/apis/pipedrive-api-v1.md) · [All operations](https://skmtc.net/pipedrive/apis/pipedrive-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedrive/pipedrive-api-v1/versions/bf863a979545/schema)