---
title: "List unseen release notes"
method: GET
path: "/api/v1/release-notes/unseen"
tags: ["internal"]
---

# List unseen release notes

`GET /api/v1/release-notes/unseen`

## Request

- Base URL: `https://app.scanopy.net`
- URL: `https://app.scanopy.net/api/v1/release-notes/unseen`
- Auth: API key in cookie `session_id`

The releases newer than the last one the caller dismissed, up to the
version this server runs.

## Response `200`

Unseen releases

- ApiResponseUnseenReleaseNotes: Envelope for a successful response. Failures are sent with a non-2xx status and an `ApiErrorResponse` body instead.
  - `data` object: The releases the caller hasn't dismissed.
    - `auto_open` boolean, required: Whether the modal opens on its own: true when any unseen release asks for it, including ones left out for the changelog.
    - `changelog_url` string, nullable: The full changelog, present when older unseen releases were left out.
    - `releases` ReleaseNoteResponse[], required: Newest first. Empty when there is nothing new.
      - `date` string, date, required: The day the release was prepared.
      - `html` string, required: The notes, as HTML rendered from the reviewed markdown, without raw HTML.
      - `title` string, required: The release's headline.
      - `url` string, required: This release on the public changelog.
      - `version` string, required: The release, as semver (e.g. `0.18.0`).
  - `error` string, nullable: Not sent on a successful response. Failure messages arrive in an `ApiErrorResponse`.
  - `meta` ApiMeta, required: API metadata included in all responses
    - `api_version` integer, required: API version (integer, increments on breaking changes)
    - `server_version` string, required: Server version (semver)
  - `success` boolean, required: Always `true` on a successful response.

## Other responses

- `401`: Not signed in

## Changes

- **2026-10-26** `c9d9d46d1ae8`: 2 info
  - api tag `internal` added
  - api tag `release-notes` removed
- **2026-10-14** `60923f001410`: 1 info
  - added the required property `data/auto_open` to the response with the `200` status
- **2026-10-11** `853906432d3c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scanopy/apis/scanopy-api/changes/api/v1/release-notes/unseen/get.md)

---

[API](https://skmtc.dev/scanopy/apis/scanopy-api.md) - [All operations](https://skmtc.dev/scanopy/apis/scanopy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scanopy/apis/scanopy-api/revisions/966ba786bdb5?raw)