Developer Portal

Use the Maldives API to programmatically manage your notes, teams, and content.

Quick Start

1. Generate an API token in Settings → API Tokens.

2. Use the token in the Authorization header:

curl -H "Authorization: Bearer mld_your_token_here" \
  https://your-domain.com/api/notes

100

requests/minute (Free)

1,000

requests/minute (Prime)

GET/api/notesList all your notesBearer token

POST/api/notesCreate a new noteBearer token

GET/api/notes/:idGet a note by ID or shortIdBearer token or public

PUT/api/notes/:idUpdate a noteBearer token (owner)

DELETE/api/notes/:idSoft-delete a noteBearer token (owner)

GET/api/notes/:id/versionsList note versionsBearer token

POST/api/notes/:id/versionsSave a named versionBearer token

GET/api/notes/:id/commentsList note commentsBearer token or public

POST/api/notes/:id/commentsAdd a commentBearer token

GET/api/foldersList folders (as tree)Bearer token

POST/api/foldersCreate a folderBearer token

PUT/api/folders/:idUpdate a folderBearer token (owner)

DELETE/api/folders/:idDelete a folderBearer token (owner)

GET/api/teamsList your teamsBearer token

POST/api/teamsCreate a teamBearer token

POST/api/images/uploadUpload an image (multipart)Bearer token

GET/api/templatesList templatesOptional

GET/api/export?noteId=X&format=md|htmlExport a noteOptional

GET/api/user/tokensList your API tokensSession

POST/api/user/tokensGenerate a new API tokenSession