---
title: "List releases (POST form)"
method: POST
path: "/changelog"
tags: ["Support"]
---

# List releases (POST form)

`POST /changelog`

## Request

- Base URL: `https://grape.cool/api/v1`
- URL: `https://grape.cool/api/v1/changelog`
- Auth: none required

Returns every desktop and mobile release, newest first within each platform, with the changes that went into it. Identical to the GET operation; the query arguments move into a JSON body.

## Request body

- object
  - `platform` 'desktop' | 'mobile': Limit the list to one platform.

## Response `200`

Every matching release.

- object
  - `success` true, required
  - `data` Release[], required
    - `version` string, required: Version tag, such as v0.24.0.
    - `date` string, required: Release date as published.
    - `platform` 'desktop' | 'mobile', required: Which app family shipped it.
    - `changes` string[], required: One line per change.
  - `meta` Meta: Counts and echoed arguments that describe the payload.
    - `total` integer: How many items exist.
    - `returned` integer: How many items this response carries.
    - `query` string: The search term that was used.
    - `currency` string: ISO 4217 code the prices are quoted in.

## Other responses

- `400`: A parameter was missing or outside the allowed values.
- `404`: Nothing matches the identifier given.
- `429`: More than 1000 requests came from this IP address in an hour.
- `500`: The request could not be completed.

---

[API](https://skmtc.dev/grape/apis/grape-public-api.md) · [All operations](https://skmtc.dev/grape/apis/grape-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grape/apis/grape-public-api/revisions/16061cbac2d4?raw)