# HackMD Versions API

**Canonical:** https://apis.io/apis/hackmd/hackmd-versions-api/  
**Provider:** HackMD — https://apis.io/providers/hackmd/  
**Base URL:** https://api.hackmd.io/v1  
**Documentation:** https://hackmd.io/@docs/developer-portal

HackMD Versions API is one of 12 APIs that [HackMD](https://apis.io/providers/hackmd/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Versions. The published artifact set on APIs.io includes an OpenAPI specification.

Operations for listing, retrieving, comparing, creating, and updating note versions.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/notes/{noteId}/versions` | List note versions |
| POST | `/notes/{noteId}/versions` | Create a named note version |
| PATCH | `/notes/{noteId}/versions` | Update named version metadata |
| GET | `/notes/{noteId}/versions/compare` | Compare note versions |
| GET | `/notes/{noteId}/versions/{versionId}` | Get a note version |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hackmd/refs/heads/main/openapi/hackmd-versions-api-openapi.yml

## Other HackMD APIs (11)

- [HackMD History API](https://apis.io/apis/hackmd/hackmd-history-api/)
- [HackMD Profile API](https://apis.io/apis/hackmd/hackmd-profile-api/)
- [HackMD Team Folders API](https://apis.io/apis/hackmd/hackmd-team-folders-api/)
- [HackMD Team Notes API](https://apis.io/apis/hackmd/hackmd-team-notes-api/)
- [HackMD Teams API](https://apis.io/apis/hackmd/hackmd-teams-api/)
- [HackMD Trash API](https://apis.io/apis/hackmd/hackmd-trash-api/)
- [HackMD User Folders API](https://apis.io/apis/hackmd/hackmd-user-folders-api/)
- [HackMD User Notes API](https://apis.io/apis/hackmd/hackmd-user-notes-api/)
- [HackMD Comments API](https://apis.io/apis/hackmd/hackmd-comments-api/)
- [HackMD Team Webhooks API](https://apis.io/apis/hackmd/hackmd-team-webhooks-api/)
- [HackMD Webhooks API](https://apis.io/apis/hackmd/hackmd-webhooks-api/)

## Tags

Versions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hackmd/hackmd-versions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hackmd/.