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

# Update a note

`PATCH /notes/{id}`

## Request

- Base URL: `https://api.parley.so/v1`
- URL: `https://api.parley.so/v1/notes/{id}`
- Auth: HTTP bearer

Rename a note or replace its content. Pass the version you last read as expectedVersion: if someone changed the note since, this returns 409 VERSION_CONFLICT and changes nothing. Omitted fields are left unchanged.

## Path parameters

- `id` string, required: The note ID.

## Request body

- object
  - `expectedVersion` integer, required: The note's version when you last read it. Returns 409 if the note changed since then: get it again, reapply your change, and retry with the new version.
  - `name` string: A new title.
  - `content` string: New markdown that replaces the whole note. Refer to a file with @[name](fileId) and a folder with @[name/](folderId), and keep existing references exactly as they are.

## Response `200`

OK

- Note
  - `id` string, required: The note ID.
  - `name` string, required: The note title.
  - `location` object, required: The project, account, or contact the note is on.
    - `type` 'project' | 'account' | 'contact', required: The kind of record: project, account, or contact.
    - `id` string, required: Its ID.
    - `name` string, required: The record's name. A contact's is its first and last name, or an email address when it has no name.
  - `version` integer, required: Goes up by one each time the content changes or the note is renamed through the API. Pass it as expectedVersion when updating the note.
  - `createdAt` string, date-time, required: When the note was created.
  - `updatedAt` string, date-time, required: When the note was last changed, including renames.

## Other responses

- `400`: The request was invalid. VALIDATION_FAILED.
- `401`: Missing or invalid credentials. UNAUTHORIZED.
- `403`: You don't have permission. FORBIDDEN.
- `404`: Not found. NOT_FOUND.
- `409`: The request conflicts with the current state. VERSION_CONFLICT.
- `429`: Too many requests, or a usage limit was reached. TOO_MANY_REQUESTS.

---

[API](https://skmtc.dev/parley/apis/parley-api.md) - [All operations](https://skmtc.dev/parley/apis/parley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parley/apis/parley-api/revisions/6b78aeee07bc?raw)