---
title: "List app image releases"
method: GET
path: "/api/app-images/{handle}/{slug}/releases"
---

# List app image releases

`GET /api/app-images/{handle}/{slug}/releases`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/app-images/{handle}/{slug}/releases`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

An installable app's deploy history, newest first.

## Path parameters

- `handle` string, required: The owner a resource is addressed under: "@username" for a personal scope, or a bare slug for a project.
- `slug` string, required: The image's identifier within its owner's scope. Chosen once and never changed.

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

OK

- PaginatedResponseAppImageReleaseSummary
  - `data` AppImageReleaseSummary[], required
    - `number` number, required
    - `created_at` string, required
    - `asset_count` number, required
    - `current` boolean, required: True for the release being served, which is the one a rollback moves.
    - `published_at` string, nullable, required: When the bytes were verified. Null for a release whose upload never finished.
  - `hasNextPage` boolean, required
  - `totalCount` number

## Other responses

- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found

---

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