---
title: "Atomically claim an unassigned cloud printer for a paired Host"
method: POST
path: "/v1/hive-link/printers/{printerId}/claim"
tags: ["Hive Link"]
---

# Atomically claim an unassigned cloud printer for a paired Host

`POST /v1/hive-link/printers/{printerId}/claim`

## Path parameters

- `printerId` string, required

## Request body

- object
  - `hostId` string, required

## Response `200`

Default Response

- object
  - `cloudPrinterId` string
  - `ownership` object
    - `status` 'available' | 'unknown' | 'owned-by-this-host' | 'owned-by-another-host', required
    - `cloudPrinterId` string
    - `authoritativeHostId` string
    - `authoritativeHostName` string
    - `assignment` object
      - `id` string
      - `hostId` string
      - `hostName` string
      - `hostHostname` string
      - `leaseHostId` string
      - `leaseHostName` string
      - `assignmentEpoch` integer
      - `leaseExpiresAt` string
      - `connectionState` string
      - `lastKnownPrinterStatus` string
      - `recoveryRequired` boolean
      - `recoveryReason` string
      - `errorCode` string
      - `errorMessage` string
      - `retryCount` integer
      - `lastAttemptAt` string
      - `uploadInProgress` boolean
      - `outcome` string
      - `fromHostId` string
      - `toHostId` string
      - `state` string
      - `error` string

## Other responses

- `201` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `503` — Default Response

---

[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/6fe5e0368cb0/schema)