Get Note

GET /api/notes/{id}

cURL

curl -X GET "https://your-domain.com/api/notes/note_abc123" \
  -H "Authorization: Bearer YOUR_TOKEN"

200

{
  "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

Show properties

content.md · string

Complete markdown content

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

curl -X GET "https://your-domain.com/api/notes/note_abc123" \
  -H "Authorization: Bearer YOUR_TOKEN"

200

{
  "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