Skip to main content
GET
/
api
/
notes
/
{id}
curl -X GET "https://your-domain.com/api/notes/note_abc123" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "id": "note_abc123",
  "user_id": "user_123",
  "title": "Meeting Notes",
  "data": {
    "content": {
      "md": "# Meeting Summary\n\nDiscussed project roadmap and timeline..."
    }
  },
  "folder_id": "folder_xyz",
  "access_grants": [
    {
      "grantee_type": "group",
      "grantee_id": "group_456",
      "permission": "read"
    }
  ],
  "write_access": true,
  "updated_at": 1709395200,
  "created_at": 1709308800
}
Retrieve a specific note by ID.

​
Authorization

Requires user permission features.notes or admin role.

​
Path Parameters

​
id
string
required
Unique identifier of the note

​
Response

Returns the note object with full content and write access indicator.
​
id
string
required
Unique identifier for the note
​
user_id
string
required
ID of the note owner
​
title
string
required
Title of the note
​
data
object
Full note content data
​
folder_id
string
ID of the folder containing the note
​
access_grants
array
Access control grants for the note
​
write_access
boolean
required
Indicates if the current user has write access to the note
​
updated_at
integer
required
Unix timestamp of last update
​
created_at
integer
required
Unix timestamp of creation
curl -X GET "https://your-domain.com/api/notes/note_abc123" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "id": "note_abc123",
  "user_id": "user_123",
  "title": "Meeting Notes",
  "data": {
    "content": {
      "md": "# Meeting Summary\n\nDiscussed project roadmap and timeline..."
    }
  },
  "folder_id": "folder_xyz",
  "access_grants": [
    {
      "grantee_type": "group",
      "grantee_id": "group_456",
      "permission": "read"
    }
  ],
  "write_access": true,
  "updated_at": 1709395200,
  "created_at": 1709308800
}

​
Access Control

  • Users must have features.notes permission enabled
  • Returns notes where user is the owner OR has read access via access grants
  • write_access is true if:
    • User is admin
    • User is the note owner
    • User has write permission via access grants
    • Note has public read access
  • Admin users can access all notes
  • Non-admin users need explicit read permission