v14

latestOpenAPI 3.0.3BSD 3-Clauseraw.githubusercontent.com2026-08-013939103.6 KB
node

Read border router device item of this node.

Shortcut into the Devices collection returning the threadBorderRouter item representing this Thread Border Router.

Failing to parse the query parameter(s) leads to a 400 Bad Request Error.

Failing to populate any of the dynamic attributes may lead to a 500 Internal Server Error.

get/api/node

Query parameters

typestring[]

A selector that allows clients to request a subset of items of the given type only:

  • with all attributes, for example, fields[addThreadDeviceTask] or fields[{type}] in general
  • with selected attributes only ("Sparse Fieldset"), fields[nodeDevice]=vendorModel,operationalDataset.active.channel or fields[{type}]={attributeKey}(,{attributeKey})* in general

Condition

The {type} must be given (in other words, not empty). The value of the parameter must be fully omitted (in other words, no = in query) or contain one or more type-specific {attributeKey}s in a comma-separated list. An {attributeKey} may use the dot notation to select a subordinate field of the attribute.

Allowed characters for {type} and {attributeKey} are alphanumeric characters, underscores (_), hyphens (-), and dots (.) for nested fields. Commas (,) are used as separators. Allowed character set (regex): ^[A-Za-z0-9_.\-\,]+$

Examples

  • ?fields[threadDevice]=hostname,role
  • ?fields[addThreadDeviceTask]=eui,pskd&fields[threadDevice]=hostname
  • ?fields[threadDevice] (all attributes for threadDevice)

Headers

Accept'application/json' | 'application/vnd.api+json'

Must be set to application/vnd.api+json or application/json

Response

(JSON:API) document with a single data object of type device representing the Thread Border Router.

object required