Currently, the trackables feature supports the pairing of a single UWB tag with one trackable at any given time.

On this page:

Each trackable is assigned a unique UUID automatically generated upon creation. Additionally, trackables include a 'name' parameter that is unrestricted and can be utilized to associate the trackable with real-world assets. It's important to note that a tag can only be paired with either zero or one trackable simultaneously. Attempting to pair a tag that is already paired will result in a validation error.

Beyond the standard CRUD (Create, Read, Update, Delete) operations, the Trackable API provides specialized pairing requests to facilitate the management of trackables:

• Pairing: Establishes a temporary one-to-one link between a tag and a trackable.
• Unpairing: Dissolves a temporary one-to-one link between a tag and a trackable.
• Replacing: Substitutes a new tag on an existing trackable.

Paring

Operation pairing can be performed by scanning in Trackables App or use REST API 

POST http://192.168.225.2/trackablesserver/api/trackables

Request body includes an information about the trackable name (e.g., work order number) and a new UWB tag:

{
    "name": "WO001",
    "location_providers": [ "0x24035FBE0BAB" ]
}

Unpairing

Operation unpairing can be performed by scanning in Trackables App or use REST API 

GET http://192.168.225.2/trackablesserver/api/trackables?name=TRACKABLE_NAME

POST http://192.168.225.19:3080/trackablesserver/api/trackables/TRACKABLE_ID/providers/unpair

Replacing

Operation unpairing can be performed by scanning in Trackables App or use REST API 

GET http://192.168.225.2/trackablesserver/api/trackables?name=TRACKABLE_NAME

POST http://192.168.225.2/trackablesserver/api/trackables/TRACKABLE_ID/providers/replace

Request body includes an information about a new UWB tag:

{
  "location_providers": [
    "0x010203040506"
  ]
}