Register a device and return its device bearer token once (scope sync:write)

POST/api/v1/sync/devices

Authorization

AuthorizationBearer token · headerrequired

Scoped API token (bnx_…). Required scopes are noted per operation.

Request body

application/json

namestringrequired

min length 1 · max length 120

platformstring

Allowed:macoswindowslinux

Responses

201

Registered device with one-time plaintext device token

idstringrequired

namestringrequired

platformstring | nullrequired

tokenstringrequired

400

Invalid request

errorstringrequired

codestringrequired

rulestring

401

Unauthenticated

errorstringrequired

codestringrequired

rulestring

403

Forbidden (missing scope or permission)

errorstringrequired

codestringrequired

rulestring

429

Rate limited

errorstringrequired

codestringrequired

rulestring

Request

curl -X POST '/api/v1/sync/devices' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "platform": "macos"
}'

const response = await fetch("/api/v1/sync/devices", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"platform\": \"macos\"\n}"
});

import requests

response = requests.post(
    "/api/v1/sync/devices",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"platform\": \"macos\"\n}",
)

Response

{
  "id": "string",
  "name": "string",
  "platform": "string",
  "token": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}