## Bulk Initiate

`gpu_droplets.actions.bulk_initiate(ActionBulkInitiateParams**kwargs)  -> ActionBulkInitiateResponse`

**post** `/v2/droplets/actions`

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_cycle`
- `power_on`
- `power_off`
- `shutdown`
- `enable_ipv6`
- `enable_backups`
- `disable_backups`
- `snapshot` (also requires `image:create` permission)

### Parameters

- **type:** `Literal["enable_backups", "disable_backups", "reboot", 12 more]`

  The type of action to initiate for the Droplet.

  - `"enable_backups"`

  - `"disable_backups"`

  - `"reboot"`

  - `"power_cycle"`

  - `"shutdown"`

  - `"power_off"`

  - `"power_on"`

  - `"restore"`

  - `"password_reset"`

  - `"resize"`

  - `"rebuild"`

  - `"rename"`

  - `"change_kernel"`

  - `"enable_ipv6"`

  - `"snapshot"`

- **tag\_name:** `str`

  Used to filter Droplets by a specific tag. Can not be combined with `name` or `type`.<br>Requires `tag:read` scope.

### Returns

- `class ActionBulkInitiateResponse`

  - **actions:** `Optional[List[Action]]`

    - **id:** `Optional[int]`

      A unique numeric ID that can be used to identify and reference an action.

    - **completed\_at:** `Optional[datetime]`

      A time value given in ISO8601 combined date and time format that represents when the action was completed.

    - **region:** `Optional[Region]`

    - **region\_slug:** `Optional[str]`

      A human-readable string that is used as a unique identifier for each region.

    - **resource\_id:** `Optional[int]`

      A unique identifier for the resource that the action is associated with.

    - **resource\_type:** `Optional[str]`

      The type of resource that the action is associated with.

    - **started\_at:** `Optional[datetime]`

      A time value given in ISO8601 combined date and time format that represents when the action was initiated.

    - **status:** `Optional[Literal["in-progress", "completed", "errored"]]`

      The current status of the action. This can be "in-progress", "completed", or "errored".

      - `"in-progress"`

      - `"completed"`

      - `"errored"`

    - **type:** `Optional[str]`

      This is the type of action that the object represents. For example, this could be "transfer" to represent the state of an image transfer action.

### Example

```python
from do_gradientai import GradientAI

client = GradientAI()
response = client.gpu_droplets.actions.bulk_initiate(
    type="reboot",
)
print(response.actions)
```