---
title: "Request Raspberry Pi image"
method: POST
path: "/v1/hosts/rpi-image"
tags: ["RPI Image"]
---

# Request Raspberry Pi image

`POST /v1/hosts/rpi-image`

Request a new Raspberry Pi image with Hive Link pre-installed

## Request body

- object
  - `hostname` string
  - `rpi_model` 'rpi4' | 'rpi5', required
  - `config` object
    - `wifi_ssid` string
    - `wifi_password` string
    - `enable_ssh` boolean
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)

## Response `200`

Default Response

- object
  - `request_id` string
  - `host_id` string
  - `hostname` string
  - `status` string
  - `estimated_time` number

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/85dda1277de0/schema)