---
title: "List pushes"
method: GET
path: "/pushes"
---

# List pushes

`GET /pushes`

## Request

- Base URL: `http://localhost:4973`
- URL: `http://localhost:4973/pushes`
- Auth: HTTP bearer

Lists outbound image push jobs, newest first.

## Response `200`

List of pushes

- Push[]
  - `id` string, required: Push job identifier
  - `image` string, required: Hypeman image name (normalized ref)
  - `digest` string, required: Cached manifest digest being pushed
  - `target` string, required: Remote reference the image is pushed to
  - `status` 'queued' | 'pushing' | 'pushed' | 'failed', required
  - `queue_position` integer, nullable: Position in the push queue
  - `error` string, nullable: Error message
  - `layers` integer: Number of layers pushed
  - `bytes` integer: Total compressed layer bytes pushed
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

## Changes

- **2026-08-21** `b00eacfe26b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kernel/apis/hypeman-api/changes/pushes/get.md)

---

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