v1

latestOpenAPI 3.1.02026-07-26183980.3 KB

external

external-v2

Update Note

Submit a complete markdown body for a note and the exact version being updated. Send the full desired body in content (not a partial markdown patch). The first line of content becomes the updated title. Trashed notes must be restored before they can be updated.

patch/v2/notes/{note_id}

Path parameters

note_idstring uuid required

UUID of the note to update. Use an ID returned by create/list/search. The caller must be able to edit this note.

Request body

contentstring required

Complete markdown body to submit for this write. Send the full desired note body (partial patch semantics are not supported in this request payload). The first line is interpreted as the title.

updated_atstring date-time nullable

Optional "last updated" timestamp for this write (ISO 8601). If omitted, the current server time is used.

versioninteger required

Exact note content document version this update is based on. Use the version returned by GET /v2/notes/{note_id} or by the most recent note write response.

Example request

{
  "content": "# Updated Meeting Notes\n\nDiscussion Topics:\n- Sprint planning\n- Release checklist\n\nAction Items:\n- Finalize scope by Friday\n- Share release notes draft",
  "updated_at": "2025-04-02T09:15:22Z",
  "version": 2
}

Response

collection_idsstring[] required

Collection UUIDs currently associated with this note.

contentstring required

Full markdown content stored after the update.

created_atstring date-time required

Creation timestamp for the note in ISO 8601 format.

idstring uuid required

UUID of the updated note.

request_idstring required

Identifier for this API request. Useful for tracing and support.

titlestring required

Current note title after the update.

trashed_atstring date-time nullable required

Timestamp for when the note was moved to trash, or null when the note is active.

updated_atstring date-time required

Last modification timestamp after the update in ISO 8601 format.

versioninteger required

Current note content document version after the update.

Example response

{
  "collection_ids": [
    "59508b41-8770-4855-aa37-302b1e09aee7",
    "026b426c-14fb-4f22-8d98-7a9121bfaec8"
  ],
  "content": "# Sales Call with Acme Corp\n\nUpdated summary and next steps.",
  "created_at": "2025-04-11T04:47:14.457Z",
  "id": "5e29c8a2-c73b-476b-9311-e2579712d4b1",
  "request_id": "api-request-036ed6c7-de00-459f-a89b-43d26aafe522",
  "title": "Sales Call with Acme Corp",
  "trashed_at": null,
  "updated_at": "2025-04-12T10:15:00.000Z",
  "version": 5
}