thing.delete

Things can be deleted by specifying any of the following:

• A single key to delete one thing.

• An array of keys to delete multiple things.

• An array of tags to delete things that have all specified tags.

• A parameter that deletes things matching a query string.

• A parameter that deletes all things.

TR50 Request

// Delete by a thing key
{
  "cmd": {
    "command": "thing.delete",
    "params": {
      "key": "mythingkey"
    }
  }
}

// Delete by thing keys
{
  "cmd": {
    "command": "thing.delete",
    "params": {
      "key": ["mythingkey1", "mythingkey2"]
    }
  }
}

// Delete by tag(s)
{
  "cmd": {
    "command": "thing.delete",
    "params": {
      "tag": ["tag1", "tag2"]
    }
  }
}
 
// Delete by query
{
  "cmd": {
    "command": "thing.delete",
    "params": {
      "query": "name:deleteme*"
    }
  }
}

// Delete all things
{
  "cmd": {
    "command": "thing.delete",
    "params": {
      "all": true
    }
  }
}
      

Request Parameters

TR50 Response

If the command is sent successfully a success message is returned. Otherwise, an error and error message will be returned.

{
  "cmd": {
    "success": true
  }
}