Subscribe to the JSON feed

Goal

Consume the MexCep changelog via JSON Feed 1.1, the modern lightweight alternative to RSS/Atom. Compatible with NetNewsWire, Reeder 5+, and any custom polling script that prefers JSON over XML.

Prerequisites

None for public entries. Admin-audience entries require a cookie session with docs:read permission.

Steps

1. Add the feed URL to your reader

https://api.example.com/v1/public/changelog/feed.json

Verify manually:

curl 'https://api.example.com/v1/public/changelog/feed.json'

The response is application/feed+json. Validate at https://validator.jsonfeed.org/.

2. Sample structure

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "MexCep Changelog",
  "home_page_url": "https://docs.example.com/en/changelog",
  "feed_url": "https://api.example.com/v1/public/changelog/feed.json",
  "language": "en",
  "authors": [{ "name": "MexCep" }],
  "items": [
    {
      "id": "https://docs.example.com/changelog/v1.49.6/url-convention",
      "url": "https://docs.example.com/changelog/v1.49.6/url-convention",
      "title": "URL convention formalized + 13 path moves",
      "summary": "Formalizes the 4-namespace URL convention and migrates 11 paths.",
      "date_published": "2026-05-28T10:30:00Z",
      "tags": ["breaking", "audience:public", "api", "routes"]
    }
  ]
}

3. Filter the feed

Param	Default	Description
`audience`	auto-detect	`public` (anon) or `admin` (cookie + `docs:read`).
`lang`	`en`	Feed language. `en` or `es`.
`limit`	`50`	Entries per feed (1–100).

# Spanish, 5 most recent entries
curl 'https://api.example.com/v1/public/changelog/feed.json?lang=es&limit=5'

Errors

Status	Code	Cause
400	`invalid_lang` / `invalid_audience` / `invalid_limit`	Param value outside the enum/range.
401	`unauthorized`	Requested `audience=admin` without cookie auth.
403	`forbidden`	Cookie present but missing `docs:read`.
429	`rate_limited`	Polling too aggressively.

Notes

Each items[].tags array carries category + audience flags so custom scripts can filter client-side without re-fetching.
For RSS/Atom-style consumers, see Subscribe to the Atom feed.
ADR-0090 (URL Convention) explains the /v1/public/* namespace move.

New in v1.49.6 — see ADR-0090.