---
search:
  tags:
    - offline-sync
    - POST
seo:
  description: >-
    Register a device and return its device bearer token once (scope
    sync:write). Reference for the POST /api/v1/sync/devices endpoint in the
    Basenet Public API.
sidebar:
  label: Register a device and return its device bearer token once (scope sync:write)
  badge: POST
title: Register a device and return its device bearer token once (scope sync:write)
type: openapi-operation
---
Endpoint: `POST /api/v1/sync/devices`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Request body (`application/json`):
- `name` (string, required)
- `platform` (one of `"macos"`, `"windows"`, `"linux"`, optional)

Responses:
- `201`: Registered device with one-time plaintext device token
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 201 body (`application/json`):
- `id` (string, required)
- `name` (string, required)
- `platform` (string or null, required)
- `token` (string, required)