This is the reference for the gRPC and HTTP APIs that The Things Stack exposes.
Note:
The Things Stack API is different from The Things Network Stack V2 API. If migrating from V2, see here for an overview of changes.Field Masks
The Things Stack APIs use field masks to specify a subset of fields that should be returned by a reading request, or to specify fields that should be updated in a writing request. See Google’s Protocol Buffers reference for more information about field masks.
HTTP Queries
Additional fields may be specified in HTTP requests by appending them as query string parameters. For example, to request the name
, description
, and locations
of devices in an EndDeviceRegistry.Get
request, add these fields to the field_mask
field. To get this data for device dev1
in application app1
:
curl -i -H "Authorization: Bearer NNSXS.XXXXXXXXX" https://thethings.example.com/api/v3/applications/app1/devices/dev1?field_mask=name,description,locations