Skip to main content
POST
/
devices
/
tags
/
{tagId}
/
unlink
Remove tag from devices
curl --request POST \
  --url https://dashboard.hologram.io/api/1/devices/tags/{tagId}/unlink \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deviceids": [
    123
  ]
}
'
import requests

url = "https://dashboard.hologram.io/api/1/devices/tags/{tagId}/unlink"

payload = { "deviceids": [123] }
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({deviceids: [123]})
};

fetch('https://dashboard.hologram.io/api/1/devices/tags/{tagId}/unlink', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
const url = 'https://dashboard.hologram.io/api/1/devices/tags/{tagId}/unlink';
const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({deviceids: [123]})
};

fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));
{
  "success": true,
  "data": {
    "tags": [
      {
        "id": 123,
        "name": "<string>",
        "deviceids": [
          123
        ]
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

HTTP Basic authentication using API keys. Set the username to apikey and the password to your API key. You can find your API key on the Hologram Dashboard under Account Settings.

Path Parameters

tagId
integer
required

ID of the device tag

Body

application/json
deviceids
integer[]

Device IDs to remove the tag from. Optional — omitting or passing an empty array is a no-op.

Response

OK

success
boolean

Indicates whether the request was successful.

Example:

true

data
object