---
title: "Read Device Release History"
method: GET
path: "/api/v1/devices/{device_id}/release-history"
tags: ["device deployments"]
---

# Read Device Release History

`GET /api/v1/devices/{device_id}/release-history`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/devices/{device_id}/release-history`
- Auth: HTTP bearer

## Path parameters

- `device_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- DeviceReleaseHistoryResponse[]
  - `history_id` string, uuid, required
  - `device_id` string, required
  - `release_id` string, uuid, required
  - `release` DockReleaseResponse, required
    - `release_id` string, uuid, required
    - `version` string, required
    - `git_commit` string, required
    - `schema_release_id` string, uuid, required
    - `schema_release` SchemaReleaseResponse, required
      - `schema_release_id` string, uuid, required
      - `version` string, required
      - `git_commit` string, required
      - `wheel_s3_key` string, required
      - `wheel_sha256` string, required
      - `created_at` string, date-time, required
      - `created_by` string, required
      - `status` 'draft' | 'released' | 'deprecated' | 'revoked', required: Operator-controlled lifecycle for immutable catalogue entries.
    - `product` 'brumby-dock', nullable, required
    - `release_purpose` 'application' | 'updater_migration', nullable, required
    - `release_format_version` string, nullable, required
    - `job_schema_version` '1' | '2', nullable, required
    - `target_hardware_family` 'n100' | 'jetson', nullable, required
    - `target_architecture` 'x86_64' | 'aarch64', nullable, required
    - `manifest_sha256` string, nullable, required
    - `signing_key_id` string, nullable, required
    - `artifact_s3_key` string, required
    - `artifact_sha256` string, required
    - `artifact_size_bytes` integer, required
    - `created_at` string, date-time, required
    - `created_by` string, required
    - `release_status` 'draft' | 'released' | 'deprecated' | 'revoked', required: Operator-controlled lifecycle for immutable catalogue entries.
    - `release_notes` string, nullable, required
    - `installable` boolean, required
  - `previous_release_id` string, uuid, nullable, required
  - `previous_release` DockReleaseResponse, required
    - `release_id` string, uuid, required
    - `version` string, required
    - `git_commit` string, required
    - `schema_release_id` string, uuid, required
    - `schema_release` SchemaReleaseResponse, required
      - `schema_release_id` string, uuid, required
      - `version` string, required
      - `git_commit` string, required
      - `wheel_s3_key` string, required
      - `wheel_sha256` string, required
      - `created_at` string, date-time, required
      - `created_by` string, required
      - `status` 'draft' | 'released' | 'deprecated' | 'revoked', required: Operator-controlled lifecycle for immutable catalogue entries.
    - `product` 'brumby-dock', nullable, required
    - `release_purpose` 'application' | 'updater_migration', nullable, required
    - `release_format_version` string, nullable, required
    - `job_schema_version` '1' | '2', nullable, required
    - `target_hardware_family` 'n100' | 'jetson', nullable, required
    - `target_architecture` 'x86_64' | 'aarch64', nullable, required
    - `manifest_sha256` string, nullable, required
    - `signing_key_id` string, nullable, required
    - `artifact_s3_key` string, required
    - `artifact_sha256` string, required
    - `artifact_size_bytes` integer, required
    - `created_at` string, date-time, required
    - `created_by` string, required
    - `release_status` 'draft' | 'released' | 'deprecated' | 'revoked', required: Operator-controlled lifecycle for immutable catalogue entries.
    - `release_notes` string, nullable, required
    - `installable` boolean, required
  - `action_id` string, uuid, required
  - `requested_by` string, required
  - `requested_at` string, date-time, required
  - `download_started_at` string, date-time, nullable, required
  - `installed_at` string, date-time, nullable, required
  - `result` 'requested' | 'downloading' | 'installed' | 'failed' | 'rejected' | 'expired', required: FleetOps' durable view of one device deployment attempt.
  - `failure_reason` string, nullable, required
  - `failure` DockReleaseFailureV2, required: Stable machine-readable failure from updater validation or installation.
    - `code` string, required
    - `phase` string, required
    - `detail` string, nullable
    - `expected` string, nullable
    - `reported` string, nullable
  - `artifact_sha256` string, required

## Other responses

- `422`: Validation Error

---

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