---
title: List changelog entries
description: Returns the changelog, newest first.
doc_version: 0.1.0-preview
last_updated: 2026-09-14
---

# List changelog entries

`GET /v1/changelog`

Returns the changelog, newest first. Each breaking entry says how to update code, with a before and an after example. Filter by since, breaking, or surface. Call it when a call fails or returns a shape that your code does not expect.

## Authentication

Send `Authorization: Bearer <GRAPHON_API_KEY>`. Read the key from the
GRAPHON_API_KEY environment variable. Never print it.

## Query parameters

- `since` (string (optional)) — Only entries on or after this date, YYYY-MM-DD.
- `breaking` (string (optional)) — true returns breaking entries only. false returns the others. One of: true, false.
- `surface` (string (optional)) — Only entries that change this surface. One of: api, storage, s3, mcp, cli, webhooks, plugin.

## Example request

```bash
curl \
  --url "https://api.graphon.ai/v1/changelog" \
  --header "Authorization: Bearer $GRAPHON_API_KEY"
```

## CLI

```bash
graphon changelog --since 2026-11-12 --breaking
```

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
