Documentation

REST API

Token-based API access for integrations, automation, and third-party workflows.

ForgeMD exposes a token-based REST API for custom integrations and automation. It is the same API the frontend uses, so anything you can do in the editor is scriptable.

Authentication

Generate an API token from your account settings, then pass it as a bearer token:

bash

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     https://api.forgemd.io/v1/documents

Example: fetching documents

bash

curl -s -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://api.forgemd.io/v1/documents?workspace_id=ws_123" \
  | jq '.data[] | {id, title, updated_at}'

Things you can automate

Create and update documents from CI pipelines or internal tools.
Pull content into dashboards, wikis, or static sites.
Sync knowledge bases between systems.
Generate content from templates with your own scripts.

Browser extension & CLI

Chrome and Firefox extensions for document access from any tab, and CLI launch support with file path arguments, are on the roadmap.