updateDevice

PATCH

/v1/devices/{node_id}

curl --request PATCH \
  --url https://testnet-rpc.necter.network/v1/devices/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "label": "example", "group_id": "example" }'

• Public RPC host (JSON only)

Authorizations

• session

Parameters

Path Parameters

node_id

required

string

/^ndsr-[0-9a-f]{16}$/

Request Body^required

Media typeapplication/json

object

label

string

<= 64 characters

group_id

string | null

Example ^generated

{
  "label": "example",
  "group_id": "example"
}

Responses

200

Updated

Media typeapplication/json

(owner sees all fields; public view omits hardware details and label)

object

node_id

required

string

/^ndsr-[0-9a-f]{16}$/

public_key

required

string

/^0x[0-9a-f]{64}$/

owner

One of:

string

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

null

null

binding_hash

One of:

string

string

/^0x[0-9a-f]{64}$/

null

null

label

string | null

group_id

string | null

class

string

Allowed values: phone tablet laptop desktop server

platform

string

Allowed values: android ios macos windows linux

os_version

string

arch

string

engine

string

Allowed values: native pulley64 pulley32

miner_version

string

ndsr_version

string

status

required

string

Allowed values: online idle offline faulty banned

status_reason

string | null

last_seen_at

integer

connected_since

One of:

integer

integer

null

null

hardware

object

cpu_model

string

cpu_cores

integer

cpu_threads

integer

ram_mb

integer

storage_free_mb

integer

gpu

One of:

null

null

object

object

vendor

string

model

string

vram_mb

integer

network

string

Allowed values: wifi ethernet cellular none

battery

boolean

os

string

arch

string

benchmark

One of:

object

object

suite

required

string

ran_at

required

integer

engine

required

string

Allowed values: native pulley64 pulley32

cases

required

Array<object>

object

name

required

string

receipt_hash

required

string

/^0x[0-9a-f]{64}$/

gas_used

required

integer

elapsed_us

required

integer

mgas_per_s

required

Array<integer>

score

required

integer

null

null

attestation

null

subscriptions

Array<string>

region

string | null

uptime_bp_7d

integer

units_7d

integer

created_at

integer

Example

{
  "class": "phone",
  "platform": "android",
  "engine": "native",
  "status": "online",
  "hardware": {
    "network": "wifi"
  },
  "benchmark": {
    "engine": "native"
  }
}

403

Authenticated but not allowed (forbidden, not_owner, not_enrolled, not_verified, scope_missing)

Media typeapplication/json

object

error

required

Stable machine code

string

message

required

string

details

object

key

additional properties

any

request_id

required

string

Example ^generated

{
  "error": "example",
  "message": "example",
  "details": {},
  "request_id": "example"
}