[ Web Proxy ]
URL:
Viewing: https://docs.digitalocean.com/reference/pydo/reference/tags/assign_resources/ [Back]  [Original]
pydo.tags.assign_resources() | DigitalOcean Documentation

For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

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.

In this article...

We can't find any results for your search.

Try using different keywords or simplifying your search terms.

Web Proxy Viewer  |  New URL  |  Original Page