---
title: "Read Bundle Deployment"
method: GET
path: "/api/v1/bundle-deployments/{deployment_id}"
tags: ["bundles"]
---

# Read Bundle Deployment

`GET /api/v1/bundle-deployments/{deployment_id}`

## 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/bundle-deployments/{deployment_id}`
- Auth: HTTP bearer

## Path parameters

- `deployment_id` string, uuid, required

## Response `200`

Successful Response

- BundleDeploymentDetailResponse
  - `deployment_id` string, uuid, required
  - `device_id` string, required
  - `companion_id` string, required
  - `binding_generation` integer, required
  - `profile` string, required
  - `kind` 'onboard' | 'upgrade' | 'rollback' | 'repair', required
  - `source_bundle_release_id` string, uuid, nullable, required
  - `target_bundle_release_id` string, uuid, required
  - `source` BundleRef, required
    - `product` string, required
    - `version` string, required
    - `profile` string, required
    - `manifest_sha256` string, required
  - `target` BundleRef, required
    - `product` string, required
    - `version` string, required
    - `profile` string, required
    - `manifest_sha256` string, required
  - `transition_id` string, uuid, nullable, required
  - `transition_sha256` string, nullable, required
  - `checkpoint` string, nullable, required
  - `previous_deployment_id` string, uuid, nullable, required
  - `phase` 'queued' | 'preflight' | 'staging' | 'entering_maintenance' | 'applying' | 'verifying' | 'exiting_maintenance' | 'complete' | 'blocked' | 'recovering' | 'failed' | 'cancelled' | 'expired' | 'recovery_required', required
  - `reason` BundleDeploymentReason, required
    - `code` string, required
    - `component` 'n100' | 'jetson' | 'teensy' | 'cube', nullable
  - `reason_detail` unknown
  - `reached_checkpoint` string, nullable, required
  - `maintenance_active` boolean, required
  - `local_target_verified` boolean, required
  - `plan_sha256` string, required
  - `plan_intent_sha256` string, required
  - `inventory_sha256` string, required
  - `inventory_source` 'onboarding_probe' | 'device_reports', required
  - `admission_deadline` string, date-time, required
  - `cancel_requested_at` string, date-time, nullable, required
  - `cancel_requested_by` string, nullable, required
  - `created_by` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required
  - `steps` BundleDeploymentStepResponse[], required
    - `step_id` string, required
    - `attempt` integer, required
    - `position` integer, required
    - `component` 'n100' | 'jetson', required
    - `operation` 'existing_dock_install' | 'existing_air_install', required
    - `release` object, required
    - `dock_release_id` string, uuid, nullable, required
    - `air_release_id` string, uuid, nullable, required
    - `child_action_id` string, uuid, nullable, required
    - `child_kind` 'diagnostic_action' | 'companion_action', nullable, required
    - `state` 'dispatching' | 'running' | 'finished' | 'refused', required
    - `outcome` 'succeeded' | 'failed' | 'locally_recovered', nullable, required
    - `outcome_reason` string, nullable, required
    - `dispatch_refusal` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `checkpoint_verified_at` string, date-time, nullable, required
  - `events` BundleDeploymentEventResponse[], required
    - `sequence` integer, required
    - `event_type` 'requested' | 'phase_changed' | 'step_started' | 'step_finished' | 'inventory_checked', required
    - `occurred_at` string, date-time, required
    - `event_sha256` string, required
    - `event_b64` string, required
    - `event` object, 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)