---
title: "Assign printer to host"
method: POST
path: "/v1/hosts/assign-printer"
tags: ["Hosts"]
---

# Assign printer to host

`POST /v1/hosts/assign-printer`

Assign a printer to a host

## Request body

- object
  - `printer_id` string, required
  - `host_id` string, required
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)

## Response `200`

Default Response

- object
  - `id` string
  - `printer_id` string
  - `host_id` string
  - `organization_id` string, nullable
  - `lease_host_id` string, nullable
  - `assignment_epoch` integer, required
  - `lease_expires_at` string, nullable
  - `connection_state` string, nullable
  - `created_at` string
  - `updated_at` string

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-08-24** `a84f052e4573` — 4 info
  - added the optional property `connection_state` to the response with the `200` status
  - added the optional property `lease_expires_at` to the response with the `200` status
  - added the optional property `lease_host_id` to the response with the `200` status
  - added the required property `assignment_epoch` to the response with the `200` status

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/hosts/assign-printer/post.md)

---

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