HackMD API

Name: HackMD API
Brand: HackMD API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentProductivityCollaborationbearer12 EndpointsREST

For Agents

Read a HackMD user's profile, create and update personal or team notes in Markdown, and pull recent note history.

Install Jentic One Beta

Connect the HackMD API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HackMD API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with HackMD API.

Get the authenticated user's HackMD profile, name, and email

List, create, update, and delete personal notes in Markdown

Retrieve a note by id with its full Markdown content and permissions

Read recent edit history across the user's notes

GET STARTED

Start building with HackMD API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use HackMD API for, with concrete tasks.

★ Meeting Summary to Shared Note

Convert a transcribed meeting recording into a Markdown summary and post it as a HackMD note that the team can edit collaboratively. The agent calls POST /teams/{teamPath}/notes with the rendered Markdown and read/write permissions, then shares the returned URL with the channel. HackMD handles real-time co-editing once humans take over.

POST /teams/engineering/notes with title 'Sprint Planning 2026-06-10' and a Markdown body summarising the transcript, returning the note URL.

Documentation Pull-Then-Update

Maintain a runbook by pulling its current Markdown via GET /notes/{noteId}, asking an LLM to refresh it based on a recent incident, and writing it back via PATCH /notes/{noteId}. Useful for SRE teams keeping playbooks current without making humans hand-edit every time.

GET /notes/{noteId}, generate a refreshed Markdown body using the incident report, then PATCH /notes/{noteId} with the new content.

Personal Note Capture from Chat

Listen to a chat channel for messages tagged for personal capture and create matching HackMD notes via POST /notes. The agent organises notes by topic in the title and dumps the full message context into the body. Knowledge workers use this to consolidate scattered chat into searchable Markdown.

POST /notes with a title from the message subject and a body containing the full thread Markdown, then return the new note id.

Team Workspace Audit

List all teams the user belongs to and enumerate their notes for a content audit. The agent walks /teams to find team paths, then walks /teams/{teamPath}/notes to inspect titles, last-modified timestamps, and tag fields. Useful for cleaning up stale documentation in large organisations.

GET /teams, then for each team GET /teams/{teamPath}/notes and report any note unmodified for over 180 days.

Agent Discovery Through Jentic

Agents discover HackMD operations by searching Jentic with intents like 'create a markdown note'. Jentic returns the matching POST /notes operation with its input schema. The bearer token is stored in the vault, never in the agent prompt.

Use Jentic search 'create a markdown note' to find POST /notes and execute it with title and content fields.

Key Endpoints

12 endpoints — hackmd is a real-time collaborative markdown editor used by engineering teams, researchers, and educators for shared notes, meeting minutes, and documentation.

METHOD

PATH

DESCRIPTION

GET

/me

Get the authenticated user's profile

GET

/notes

List the user's personal notes

POST

/notes

Create a new personal note

PATCH

/notes/{noteId}

Update a personal note's content

GET

/history

Read recent edit history

GET

/teams

List the user's teams

POST

/teams/{teamPath}/notes

Create a note inside a team workspace

GET

/me

Get the authenticated user's profile

GET

/notes

List the user's personal notes

POST

/notes

Create a new personal note

PATCH

/notes/{noteId}

Update a personal note's content

GET

/history

Read recent edit history

GET

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The HackMD Bearer token is stored encrypted in the Jentic vault. Agents receive scoped access tokens at execution time and never see the raw value.

Intent-based discovery

Agents search Jentic for 'create a markdown note' or 'list team notes' and receive the matching HackMD operation with input schema.

Time to first call

Direct HackMD integration: a few hours to handle Bearer auth, team paths, and permission flags. Through Jentic: under fifteen minutes to search, load, and execute.

FAQs

Specific to using HackMD API through Jentic.

What authentication does the HackMD API use?

HackMD uses Bearer token authentication. Generate a token from the HackMD account settings under API tokens and pass it as Authorization: Bearer <token>. Through Jentic, the token stays encrypted in the vault and is injected at execution time so the agent never sees the raw value.

Can I create a Markdown note in a team workspace?

Yes. POST /teams/{teamPath}/notes with the title, content, readPermission, and writePermission fields creates the note inside the team. The teamPath is the slug shown in the team URL. The response returns the note id and shareable URL.

How do I update an existing HackMD note?

PATCH /notes/{noteId} updates the note's content and metadata. Pass the full new Markdown body in the content field. For team-owned notes, use PATCH /teams/{teamPath}/notes/{noteId} instead. The endpoint requires write permission on the note.

What rate limits apply to the HackMD API?

HackMD enforces per-token rate limits and returns 429 when exceeded. Public documentation lists a soft ceiling of around 100 requests per hour for read operations and a stricter limit for writes. Agents should respect 429 responses and back off.

How do I post a meeting summary to HackMD through Jentic?

Run pip install jentic, then search 'create a markdown note in a team' to find POST /teams/{teamPath}/notes. Load the schema, fill in title, content, and team path, and execute. The full flow takes under five minutes once the team path is known.

Can I see who edited a note recently?

GET /history returns recently edited notes for the authenticated user with last-changed timestamps, but the API does not expose a per-note revision diff. For collaborative authoring history, follow the note URL into HackMD's web UI which shows the full revision pane.

HackMD API

Connect the HackMD API to your agent

Capabilities

Start building with HackMD API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs