Skip to main content

Changelog API

Publish release notes from code, a CLI, or an AI coding agent. Entries are Markdown, can be scheduled, and are served on a hosted page at launch.nordva.dev/log/<your-slug> or on your own domain.

Get an API key → Quickstart

What exists today

  • Entries are Markdown with a title, category and optional scheduled publish time. Scheduled entries go live on a one-minute cron.
  • Every project gets a hosted public changelog page. Builder projects can serve it from a custom domain with managed TLS.
  • Readers can subscribe by email; new published entries are delivered as email notifications with one-click unsubscribe.
  • A public JSON feed exists per project, and a script-tag widget renders the changelog inside your own site.
  • The MCP server exposes publishing, listing and archiving as tools, so Claude Code or Cursor can ship notes at the end of a session.

Endpoints

POST /v1/changelog/entries Create or schedule an entry
GET /v1/changelog/entries List published entries
PATCH /v1/changelog/entries/{id} Update a draft or scheduled entry
DELETE /v1/changelog/entries/{id} Archive an entry
POST /v1/changelog/subscribers Subscribe an email address
GET /public/changelog/{slug} Public feed, no auth

Full reference with request and response schemas: docs.nordva.dev. Every response uses the same envelope and stable error codes.

MCP tools

The same operations are available to Claude Code, Claude Desktop and Cursor through the Nordva MCP server at mcp.nordva.dev:

  • publish_changelog_entry
  • list_changelog_entries
  • archive_changelog_entry
  • register_custom_domain
  • get_custom_domain_status

Arguments, example prompts and client setup →

Questions

Can I publish from CI?
Yes. POST /v1/changelog/entries with a secret key. Requests accept an Idempotency-Key header, so a retried pipeline step will not create a duplicate entry.
Do readers need an account?
No. The hosted page and the JSON feed are public. Subscribing only requires an email address, confirmed by a one-click link.
Can I use my own domain?
On the Builder plan. Point a CNAME at widget.nordva.dev and register the hostname; certificates are issued automatically.