Update Note

POST /api/notes/{id}/update

cURL

curl -X POST "https://your-domain.com/api/notes/note_abc123/update" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Meeting Notes",
    "data": {
      "content": {
        "md": "# Meeting Summary (Updated)\n\nAdded action items..."
      }
    }
  }'

200

{
  "id": "note_abc123",
  "user_id": "user_123",
  "title": "Updated Meeting Notes",
  "data": {
    "content": {
      "md": "# Meeting Summary (Updated)\n\nAdded action items..."
    }
  },
  "folder_id": null,
  "access_grants": [],
  "updated_at": 1709395500,
  "created_at": 1709308800
}

Update an existing note by ID.

Authorization

Requires user permission features.notes or admin role, plus write access to the note.

Path Parameters

id · string · required

Unique identifier of the note to update

Request Body

title · string

Updated title of the note

data · object

Updated note content data

Show properties

content.md · string

Updated markdown content

folder_id · string

ID of the folder to move the note to

access_grants · array

Updated access control grants for sharing the note

Show properties

grantee_type · string

Type of grantee: user, group, or public

grantee_id · string

ID of the user or group (omit for public)

permission · string

Permission level: read or write

Response

Returns the updated note object.

id · string · required

Unique identifier for the note

user_id · string · required

ID of the note owner

title · string · required

Updated title of the note

data · object

Updated note content data

folder_id · string

ID of the folder containing the note

access_grants · array

Updated access control grants for the note

updated_at · integer · required

Unix timestamp of last update

created_at · integer · required

Unix timestamp of creation

cURL

curl -X POST "https://your-domain.com/api/notes/note_abc123/update" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Meeting Notes",
    "data": {
      "content": {
        "md": "# Meeting Summary (Updated)\n\nAdded action items..."
      }
    }
  }'

200

{
  "id": "note_abc123",
  "user_id": "user_123",
  "title": "Updated Meeting Notes",
  "data": {
    "content": {
      "md": "# Meeting Summary (Updated)\n\nAdded action items..."
    }
  },
  "folder_id": null,
  "access_grants": [],
  "updated_at": 1709395500,
  "created_at": 1709308800
}

Access Control

• Users must have features.notes permission enabled
• User must be the note owner OR have write access via access grants
• Admin users can update any note
• Access grants are filtered based on sharing.public_notes permission
• Emits WebSocket event note-events to room note:{id} after successful update