{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Some actions can be performed in bulk on tagged Droplets. The actions can be\ninitiated by sending a POST to `/v2/droplets/actions?tag_name=$TAG_NAME` with\nthe action arguments.\n\nOnly a sub-set of action types are supported:\n\n- `power_cycle`\n- `power_on`\n- `power_off`\n- `shutdown`\n- `enable_ipv6` (**Warning:** The Droplet must be powered off before enabling IPv6 on an existing Droplet.)\n- `enable_backups`\n- `disable_backups`\n- `snapshot` (also requires `image:create` permission)\n","properties":{"query":{"type":"object","properties":{"tag_name":{"type":"string","examples":["env:prod"],"description":"Used to filter Droplets by a specific tag. Can not be combined with `name` or `type`.<br>Requires `tag:read` scope."}},"required":[],"additionalProperties":false},"body":{"oneOf":[{"$ref":"#/definitions/droplet_action"},{"$ref":"#/definitions/droplet_action_snapshot"}]}},"required":[],"additionalProperties":false,"definitions":{"droplet_action":{"required":["type"],"type":"object","description":"Specifies the action that will be taken on the Droplet.","properties":{"type":{"type":"string","enum":["enable_backups","disable_backups","reboot","power_cycle","shutdown","power_off","power_on","restore","password_reset","resize","rebuild","rename","change_kernel","enable_ipv6","snapshot"],"description":"The type of action to initiate for the Droplet.","examples":["reboot"]}}},"droplet_action_snapshot":{"allOf":[{"$ref":"#/definitions/droplet_action"},{"type":"object","properties":{"name":{"type":"string","description":"The name to give the new snapshot of the Droplet.","examples":["Nifty New Snapshot"]}}}]}}},"name":"Acting on Tagged Droplets","id":"digitalocean.dropletactions_post_bytag","example":{},"maxRequests":1,"summary":false}}