Release Note
Validated on 15 Feb 2019 • Last edited on 24 Jan 2025
As announced on 5 September 2018, the last_tagged attribute returned in response to GET requests to the /v2/tags or /v2/tags/$TAG_NAME endpoints has been deprecated. Beginning 1 March 2019, last_tagged is no longer populated in favor of the last_tagged_uri attribute.
For example, a GET request to /v2/tags/frontend currently might return:
{
"tag": {
"name": "frontend",
"resources": {
"count": 3,
"last_tagged_uri": "https://api.digitalocean.com/v2/droplets/132000916",
"droplets": {
"count": 3,
"last_tagged": {
"id": 132000916,
"name": "suspicious-bhabha-u8zq",
"memory": 2048,
"vcpus": 2,
"disk": 60,
"locked": false,
"status": "active",
"kernel": null,
"created_at": "2019-02-13T05:29:52Z",
"features": [
"private_networking"
],
"backup_ids": [],
"next_backup_window": null,
"snapshot_ids": [],
"image": {
"id": 43509743,
"name": "do-kube-1.12.3",
"distribution": "Debian",
"slug": null,
"public": false,
"regions": [
"ams2",
"ams3",
"blr1",
"fra1",
"lon1",
"nyc1",
"nyc2",
"nyc3",
"sfo1",
"sfo2",
"sgp1",
"tor1"
],
"created_at": "2019-02-11T20:38:04Z",
"min_disk_size": 20,
"type": "snapshot",
"size_gigabytes": 2.99
},
"volume_ids": [],
"size": {
"slug": "s-2vcpu-2gb",
"memory": 2048,
"vcpus": 2,
"disk": 60,
"transfer": 3,
"price_monthly": 15,
"price_hourly": 0.02232,
"regions": [
"ams2",
"ams3",
"blr1",
"fra1",
"lon1",
"nyc1",
"nyc2",
"nyc3",
"sfo1",
"sfo2",
"sgp1",
"tor1"
],
"available": true
},
"size_slug": "s-2vcpu-2gb",
"networks": {
"v4": [
{
"ip_address": "192.0.2.255",
"netmask": "255.255.240.0",
"gateway": "192.0.2.1",
"type": "public"
},
{
"ip_address": "10.136.121.81",
"netmask": "255.255.0.0",
"gateway": "10.136.0.1",
"type": "private"
}
],
"v6": []
},
"region": {
"name": "New York 1",
"slug": "nyc1",
"sizes": [
"s-1vcpu-3gb",
"s-1vcpu-1gb",
"s-3vcpu-1gb",
"s-1vcpu-2gb",
"s-2vcpu-2gb",
"s-2vcpu-4gb",
"s-4vcpu-8gb",
"s-16vcpu-64gb",
"s-6vcpu-16gb",
"s-8vcpu-32gb",
"s-12vcpu-48gb",
"s-20vcpu-96gb",
"s-24vcpu-128gb",
"s-32vcpu-192gb"
],
"features": [
"private_networking",
"backups",
"ipv6",
"metadata",
"install_agent",
"server_id",
"management_networking"
],
"available": true
},
"tags": [
"frontend"
]
},
"last_tagged_uri": "https://api.digitalocean.com/v2/droplets/132000916"
},
"images": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/images/42991114"
},
"volumes": {
"count": 0
}
}
}
}Following this change, the new response would look like:
{
"tag": {
"name": "frontend",
"resources": {
"count": 3,
"last_tagged_uri": "https://api.digitalocean.com/v2/droplets/132000916",
"droplets": {
"count": 3,
"last_tagged_uri": "https://api.digitalocean.com/v2/droplets/132000916"
},
"images": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/images/42991114"
},
"volumes": {
"count": 0
}
}
}
}For additional information, see the full API reference documentation for tags.