Update Note

Update a note's title, body, parent folder, or object link. This is a partial update — only the fields you send are changed. Replacing note_data records a new entry in the note's version history. To add to the end of a note without replacing it, use append-note.md.

PATCH /v1/notes/{uuid}
Content-Type: application/json

Path parameters

Parameter	Description
uuid	UUID of the note to update.

Request body

At least one field is required.

Field	Type	Description
note_tag	string	New title. Cannot be empty or null.
note_data	string (HTML) or null	Replaces the entire note body. Normalized through the rich-text renderer. null clears the body.
parent_id	string or null	Move the note into another folder (must be a folder in the same case). null moves the note to the case root.
object_id	string	Re-link the note to a different object. Replaces any existing link; requires object_type.
object_type	string	One of timeline_event, task, case, evidence, acquisition.

Example request

{
  "note_tag": "Initial Triage (revised)",
  "note_data": "<h2>Intake</h2><p>Device received, photographed, and bagged.</p>"
}

Response — 200 OK

Returns the updated note with content included (same shape as get-notes.md):

{
  "data": {
    "case_note_id": 119,
    "uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "note_tag": "Initial Triage (revised)",
    "note_data": "<h2>Intake</h2><p>Device received, photographed, and bagged.</p>",
    "path": "/Triage/Initial Triage (revised)",
    "parent_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "is_folder": false,
    "created_on": "2026-08-03T14:21:09.000Z",
    "updated_on": "2026-08-03T16:40:12.000Z",
    "attachments": [],
    "linked_case": { "case_id": 42, "uuid": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" },
    "linked_object": null,
    "created_by": { "user_id": 12, "email": "[e-mail]", "first_name": "API", "last_name": "User", "full_name": "API User", "title": "Integration" },
    "updated_by": { "user_id": 12, "email": "[e-mail]", "first_name": "API", "last_name": "User", "full_name": "API User", "title": "Integration" }
  }
}

Examples

Rename a note

response = session.patch(
    f"{BASE_URL}/notes/0f8fad5b-d9cb-469f-a165-70867728950e",
    json={"note_tag": "Initial Triage (revised)"},
)
response.raise_for_status()

Replace the note body

response = session.patch(
    f"{BASE_URL}/notes/0f8fad5b-d9cb-469f-a165-70867728950e",
    json={"note_data": "<p>Rewritten from the imaging worksheet.</p>"},
)
print(response.json()["data"]["updated_on"])

Move a note into a folder / back to the root

# Into a folder
session.patch(f"{BASE_URL}/notes/{note_uuid}", json={"parent_id": folder_uuid})

# Back to the case root
session.patch(f"{BASE_URL}/notes/{note_uuid}", json={"parent_id": None})

Re-link a note to a different evidence item

session.patch(f"{BASE_URL}/notes/{note_uuid}", json={
    "object_id": "5a2d9c1e-8877-4c1b-b7d3-0d7f2f8f4e21",
    "object_type": "evidence",
})

Errors

Status	Body	Cause
400	{"message": "Invalid request body", "errors": [...]}	No updatable fields sent, empty note_tag, invalid object_type, ...
400	{"message": "Parent note with UUID ... is not a folder"}	parent_id references a regular note (or a folder in another case / a missing note — see create-note.md for all three variants).
404	{"message": "Note not found"}	No note with that UUID.
401	Unauthorized	Missing or invalid API key.