pydo.droplet_actions.post_by_tag()
Generated on 29 Oct 2025
from pydo version
v0.18.0
Description
Some actions can be performed in bulk on tagged Droplets. The actions can be
initiated by sending a POST to /v2/droplets/actions?tag_name=$TAG_NAME with
the action arguments.
Only a sub-set of action types are supported:
power_cyclepower_onpower_offshutdownenable_ipv6enable_backupsdisable_backupssnapshot(also requiresimage:createpermission)
Parameters
| Name | Type | Required | Description | Default Value |
|---|---|---|---|---|
tag_name |
string | False | Used to filter Droplets by a specific tag. Can not be combined with name or type.Requires tag:read scope. |
|
body |
JSON or IO[bytes] | False | The type attribute set in the request body will specify the action that |
|
| will be taken on the Droplet. Some actions will require additional | ||||
| attributes to be set as well. | ||||
Request Sample
import os
from pydo import Client
client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
req = {
"type": "enable_backups"
}
resp = client.droplet_actions.post_by_tag(tag_name="production",body=req)More Information
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.