Create a new note on the HedgeDoc instance. Returns JSON with two fields: 'note_id' (the unique identifier / URL slug) and 'url' (the full URL where the note can be viewed or shared). Use alias to assign a human-readable slug such as 'q3-research-notes' — alias-based notes can later be overwritten with hedgedoc_update_note. Notes created without an alias get a random ID and cannot be updated over HTTP. Alias support requires FreeURL mode enabled on the server (CMD_ALLOW_FREEURL=true).

Fetch the raw markdown content of an existing note by its ID or alias. Returns the note's markdown as a plain string. This is a public endpoint — no authentication is required to read notes on instances that allow public access.

Overwrite the entire content of an existing note. IMPORTANT: this only works for notes that were originally created with a custom alias (via hedgedoc_create_note's alias parameter). HedgeDoc 1.x has no REST update endpoint for random-ID notes — those can only be edited live in the browser. If the target note was created without an alias, this call will fail. The update is a full overwrite — partial/patch updates are not supported.

Get metadata for a note. Returns JSON with: 'title' (string), 'description' (string or null), 'viewcount' (integer — total views), 'createtime' and 'updatetime' (ISO 8601 timestamps, e.g. '2026-08-16T10:30:00.000Z'). This is a public endpoint — no authentication required.

Verify the current session is valid and return the logged-in user's profile. Returns JSON with user info (name, email, photo, provider, etc.). Call this to confirm the server is correctly authenticated before attempting write operations, or to identify which account is active.

List the logged-in user's recently viewed and pinned notes. Returns a JSON array of note objects. Each object includes: 'id' (note ID or alias), 'text' (note title), 'tags' (array of strings), 'pinned' (boolean), and 'time' (last-viewed timestamp in milliseconds). Requires a valid session — will raise an error if not authenticated.