---
title: "Read Device Dock Releases"
method: GET
path: "/api/v1/devices/{device_id}/dock-releases"
tags: ["device deployments"]
---

# Read Device Dock Releases

`GET /api/v1/devices/{device_id}/dock-releases`

## 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}/dock-releases`
- Auth: HTTP bearer

## Path parameters

- `device_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- DeviceDockReleaseResponse[]
  - `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
  - `compatibility` DockReleaseCompatibilityResponse, required
    - `status` 'compatible' | 'incompatible' | 'unknown', required
    - `compatible` boolean, nullable, required
    - `selected_job_schema_version` '1' | '2', nullable, required
    - `reasons` ReleaseCompatibilityReason[]
      - `code` string, required
      - `message` string, required
      - `expected` string, nullable
      - `reported` string, nullable
  - `updater_migration` UpdaterMigrationEligibilityResponse, required
    - `required` boolean, required
    - `eligible` boolean, required
    - `authorization_id` string, uuid, nullable
    - `authorization_expires_at` string, date-time, nullable
    - `reasons` ReleaseCompatibilityReason[]
      - `code` string, required
      - `message` string, required
      - `expected` string, nullable
      - `reported` string, nullable

## 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)