Give Feedback

pydo.tags.assign_resources()

Generated on 3 Aug 2026 from pydo version v0.40.0

Copy page as Markdown View page as Markdown

Usage

client.tags.assign_resources(
    tag_id="awesome",
    body={
        "resources": [...],
    },
)

Returns NoneRaises HttpResponseError

Description

Resources can be tagged by sending a POST request to /v2/tags/{tag_id}/resources with an array of json objects containing resource_id and resource_type attributes.

Currently only tagging of Droplets, Databases, Images, Volumes, and Volume Snapshots is supported. resource_type is expected to be the string droplet, database, image, volume or volume_snapshot. resource_id is expected to be the ID of the resource as a string.

In order to tag a resource, you must have both tag:create and <resource type>:update scopes. For example, to tag a Droplet, you must have tag:create and droplet:update.

Parameters

tag_id string required

The name of the tag. Tags may contain letters, numbers, colons, dashes, and underscores. There is a limit of 255 characters per tag.

Max length: 255

resources array of objects required

Example: [{'resource_id': '9569411', 'resource_type': 'droplet'}, {'resource_id': '7555620', 'resource_type': 'image'}, {'resource_id': '3d80cb72-342b-4aaa-b92e-4e4abb24a933', 'resource_type': 'volume'}]

An array of objects containing resource_id and resource_type
attributes.

This response will only include resources that you are authorized to see.
For example, to see Droplets, include the droplet:read scope.

Show child properties

resource_id string optional

Example: 3d80cb72-342b-4aaa-b92e-4e4abb24a933

The identifier of a resource.

resource_type string optional

The type of the resource.

One of: droplet, image, volume, volume_snapshot

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "resources": [
    {
      "resource_id": "9569411",
      "resource_type": "droplet"
    },
    {
      "resource_id": "7555620",
      "resource_type": "image"
    },
    {
      "resource_id": "3d80cb72-342b-4aaa-b92e-4e4abb24a933",
      "resource_type": "volume"
    }
  ]
}

resp = client.tags.assign_resources(tag_id="awesome", body=req)

More Information

See /v2/tags/{tag_id}/resources in the API reference for additional detail on responses, headers, parameters, and more.