---
title: "Create Dock Release"
method: POST
path: "/api/v1/admin/dock-releases"
tags: ["release administration"]
---

# Create Dock Release

`POST /api/v1/admin/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/admin/dock-releases`
- Auth: HTTP bearer

## Request body

- DockReleaseRegistration
  - `version` string, required
  - `git_commit` string, required
  - `schema_version` string, required
  - `product` 'brumby-dock', required
  - `release_purpose` 'application' | 'updater_migration', required
  - `release_format_version` string, required
  - `job_schema_version` '1' | '2', required
  - `target_hardware_family` 'n100' | 'jetson', required
  - `target_architecture` 'x86_64' | 'aarch64', required
  - `manifest_sha256` string, required
  - `signing_key_id` string, required
  - `artifact_s3_key` string, required
  - `artifact_sha256` string, required
  - `artifact_size_bytes` integer, required
  - `release_status` 'draft' | 'released' | 'deprecated' | 'revoked': Operator-controlled lifecycle for immutable catalogue entries.
  - `release_notes` string, nullable
  - `created_at` string, date-time, nullable

## Response `201`

Successful Response

- DockReleaseRegistrationResponse
  - `created` boolean, required
  - `dock_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

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