developer documentation · v1

the claudemon api

release notes from five ai developer tools, in one consistent feed.

publicread onlyno api key
01 / start here

your first request

get the three newest releases. each record keeps its original notes, source link and date provenance.

base URL https://claudemon.com/api/v1

OpenAPI specification · RSS feed

terminal
curl "https://claudemon.com/api/v1/releases?limit=3"

JSON over HTTPS. newest first. no setup required.

02 / make it yours

build your feed

choose what you follow, then run a real request. your filters are saved in this page’s URL.

your request
curl "https://claudemon.com/api/v1/releases?limit=3"

ready when you are. no request has been run.

03 / the essentials

four endpoints. one feed.

method / pathreturns
GET /api/v1/releasespaginated releases: { releases, cursor }
GET /api/v1/releases/latestthe latest release per source
GET /api/v1/sourcessource metadata and ingestion status
GET /api/healthservice health

all parameters, schemas and response examples ↗

know what you’re getting

source IDcoverage
claude-codeClaude Code changelog
codexstable Codex CLI releases
cursorCursor changelog
geministable Gemini CLI releases
grokGrok API release notes

coverage follows official exposed history, with gaps where upstream dates or records are unavailable. Gemini and Grok coverage does not include their consumer chat apps.

pagination

pass the returned cursor unchanged, keeping the same source and since filters. repeat source to include multiple sources. stop at cursor: null. older undated historical imports follow the live feed.

dates with context

date_kind distinguishes publication from first seen. calendar-only dates use UTC midnight, not a precise release time. since filters publication dates; it is not a complete sync mechanism for edits or late discoveries.

poll politely

public API responses cache for five minutes. poll no more often than that, and send the previous ETag in If-None-Match to reuse an unchanged response on 304. cache age is not upstream freshness; check source ingestion timestamps separately.

keep the original

link back using url. body_md is untrusted upstream text: escape it or sanitize rendered Markdown before displaying it.

errors you can handle

check the HTTP status before reading data. invalid filters or cursors return 400; errors use one JSON envelope.

{ "error": { "code": "invalid_source", "message": "Unknown source." } }

illustrative error response; see the reference for exact messages.

api changes

· v1 documentation

interactive explorer, OpenAPI reference and conditional requests. existing v1 paths and response fields stay compatible. clients should tolerate new fields; breaking contract changes require a new API version.