Create Note

POST /api/notes/create

cURL

curl -X POST "https://your-domain.com/api/notes/create" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Project Ideas",
    "data": {
      "content": {
        "md": "# New Feature Ideas\n\n- Add dark mode\n- Improve search"
      }
    }
  }'

200

{
  "id": "note_xyz789",
  "user_id": "user_123",
  "title": "Project Ideas",
  "data": {
    "content": {
      "md": "# New Feature Ideas\n\n- Add dark mode\n- Improve search"
    }
  },
  "folder_id": null,
  "access_grants": [],
  "updated_at": 1709395200,
  "created_at": 1709395200
}

Create a new note for the authenticated user.

Authorization

Requires user permission features.notes or admin role.

Request Body

title · string · required

Title of the note

data · object

Note content data

Show properties

content.md · string

Markdown content of the note

folder_id · string

ID of the folder to place the note in

access_grants · array

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 created note object.

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

Note content data

folder_id · string

ID of the folder containing the note

access_grants · array

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/create" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Project Ideas",
    "data": {
      "content": {
        "md": "# New Feature Ideas\n\n- Add dark mode\n- Improve search"
      }
    }
  }'

200

{
  "id": "note_xyz789",
  "user_id": "user_123",
  "title": "Project Ideas",
  "data": {
    "content": {
      "md": "# New Feature Ideas\n\n- Add dark mode\n- Improve search"
    }
  },
  "folder_id": null,
  "access_grants": [],
  "updated_at": 1709395200,
  "created_at": 1709395200
}

Access Control

• Users must have features.notes permission enabled
• The authenticated user becomes the owner of the note
• Access grants are filtered based on user permissions
• Public sharing requires sharing.public_notes permission