These docs are for v2.0. Click to read the latest docs for v3.3.

Magic resources are specials resources that start with $, and have some special behaviors, like trigger some common task, or update static data. These resources can be used as the others using read and write operations.

📘

Remember to replace THING_TOKEN with the thing token that you got when you activated your thing and $MAGIC_RESOURCE with the magic resource name (see below).

🚧

Magic resource handlers are processed asynchronously: mixing various magic resources in a single request may have an unexpected behavior because order might not be respected.

$geo resource

This resource allows the retrieval of the current thing position in GeoJSON format.

curl -i -H "Accept: application/json" \
  -X GET "https://api.thethings.io/v2/things/THING_TOKEN/resources/$geo" \
  -k
[
  {
    "key": "$geo",
    "value": {
      "type": "Point",
      "coordinates": [2.154007, 41.390205]
    }
  }
]

$settings resource

This resource allows the retrieval of the thing settings meta-data storage. It also permits to get a single value at path (in dot separated format).

curl -i -H "Accept: application/json" \
  -X GET "https://api.thethings.io/v2/things/THING_TOKEN/resources/$settings.name" \
  -k
[
  {
    "key": "$settings.name",
    "value": "My Thing"
  }
]
Language
Click Try It! to start a request and see the response here!