---
title: "Resolve a local printer to its canonical cloud identity"
method: POST
path: "/v1/hive-link/printers/resolve"
tags: ["Hive Link"]
---

# Resolve a local printer to its canonical cloud identity

`POST /v1/hive-link/printers/resolve`

## Request body

- object
  - `hostId` string, required
  - `ip` string, required
  - `name` string
  - `serial` string
  - `model` string
  - `protocol` 'bambu' | 'klipper' | 'octoprint' | 'prusa_connect' | 'snapmaker', required
  - `createIfMissing` boolean

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

- `401` — Default Response
- `403` — 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/535140848bc4/schema)