Subscribe to the Atom feed

Goal

Subscribe to the Veriko changelog via a standards-compliant Atom 1.0 feed. Works with every modern RSS reader (Feedly, NetNewsWire, Inoreader, Thunderbird, Apple Mail) and with automation tools that poll feeds for release-triggered workflows (Zapier, n8n, GitHub Actions cron).

Prerequisites

None for public-audience entries — the feed serves them to anonymous clients. Admin-audience entries are out of reach for a feed reader: they are served only with a console session and the owner or admin role.

Steps

1. Add the feed URL to your reader

https://api.veriko.mx/v1/public/changelog/feed.atom

Most readers auto-detect the feed and prompt for a subscription. To verify manually:

curl 'https://api.veriko.mx/v1/public/changelog/feed.atom'

The response is application/atom+xml. Validate at https://validator.w3.org/feed/.

2. Sample structure

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <id>https://api.veriko.mx/v1/public/changelog/feed.atom</id>
  <title>Veriko Changelog</title>
  <updated>2026-05-28T11:00:00Z</updated>
  <link rel="self" href="https://api.veriko.mx/v1/public/changelog/feed.atom" />
  <link rel="alternate" href="https://docs.veriko.mx/en/changelog" />
  <author><name>Veriko</name></author>
  <entry>
    <id>https://docs.veriko.mx/changelog/v1.49.6/url-convention</id>
    <title>URL convention formalized + 13 path moves</title>
    <updated>2026-05-28T10:30:00Z</updated>
    <link rel="alternate" href="https://docs.veriko.mx/changelog/v1.49.6/url-convention" />
    <summary>...</summary>
    <category term="breaking" />
  </entry>
</feed>

3. Filter the feed

Param	Default	Description
`audience`	auto-detect	`public` (anonymous) or `admin` (console session with the owner or admin role only).
`lang`	`en`	Feed language. `en` or `es`.
`limit`	`50`	Entries per feed (1–100).

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

The server enforces audience against your auth. An anonymous request cannot escalate to audience=admin and receive admin entries.

Errors

Status	Code	Cause
400	`invalid_lang` / `invalid_audience` / `invalid_limit`	Param value outside the enum/range.
401	`unauthorized`	Requested `audience=admin` while unauthenticated.
403	`permission_denied`	Authenticated, but without the owner or admin role.
429	`rate_limit_exceeded`	Feed poll rate too high. Use the `ETag` of `GET /v1/public/changelog` instead.

Notes

An entry can leave the feed: if its release is canceled or a deprecation passes its sunset date. The feed also carries only the limit most recent entries.
The <updated> timestamp on each entry reflects the release's published_at, not the body's last edit.
Need JSON instead? See Subscribe to the JSON feed.
These routes live under /v1/public/*, the namespace reserved for the public catalogue served without authentication.