---
title: "Sync Device"
method: POST
path: "/api/devices/sync"
---

# Sync Device

`POST /api/devices/sync`

## Request

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

Upsert a device row from Jetson-side local provisioning.
This is intentionally narrow: it only mirrors a locally-created device identity
into the cloud registry so later websocket sessions can authenticate.

## Headers

- `authorization` string, nullable
- `x-device-sync-secret` string, nullable

## Request body

- DeviceSyncRequest
  - `device_id` string, required
  - `device_secret` string, nullable
  - `auth_scheme` string, nullable
  - `environment` string, nullable
  - `public_key` string, nullable
  - `public_key_fingerprint` string, nullable
  - `owner_user_id` integer, nullable
  - `farm_id` integer, nullable
  - `friendly_name` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)