---
title: "Enroll"
method: POST
path: "/v1/devices/enroll"
---

# Enroll

`POST /v1/devices/enroll`

## Request

- Base URL: `https://api.flanner.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flanner.io/v1/devices/enroll`
- Auth: none declared

Redeem an enrolment code and return this device's first entitlement.

## Request body

- EnrollDevice: Redeem an enrolment code minted by a machine the member already holds.
  - `enrollment_code` string, required
  - `public_key` string, required
  - `label` string, nullable
  - `platform` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/flanner/apis/flanner-control-plane.md) · [All operations](https://skmtc.dev/flanner/apis/flanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/flanner/apis/flanner-control-plane/revisions/96c571cfab10?raw)