---
title: "POST /v1/hive-link/enrollment-attempts"
method: POST
path: "/v1/hive-link/enrollment-attempts"
---

# POST /v1/hive-link/enrollment-attempts

`POST /v1/hive-link/enrollment-attempts`

## Request body

- object
  - `method` union, required
    - 'desktop_pairing'
    - 'preprovisioned_image'
  - `hostId` string, uuid
  - `replaceNonterminal` boolean
  - `retryOfAttemptId` string, uuid
  - `idempotencyKey` string

## Response `200`

Default Response

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-09-27** `3dea7fda80a8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/hive-link/enrollment-attempts/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.dev/printhiv3d/apis/hive-api-documentation/revisions/3dea7fda80a8?raw)