Give Feedback

pydo.reserved_ipv6_actions.post()

Generated on 8 May 2026 from pydo version v0.34.0

Copy page as Markdown View page as Markdown

Usage

client.reserved_ipv6_actions.post(
    reserved_ipv6="2409:40d0:f7:1017:74b4:3a96:105e:4c6e",
    body={
        "type": "assign",
        "droplet_id": 758604968,
    },
)

Returns JSONRaises HttpResponseError

Description

To initiate an action on a reserved IPv6 send a POST request to /v2/reserved_ipv6/{reserved_ipv6}/actions. In the JSON body to the request, set the type attribute to on of the supported action types:

Action	Details
`assign`	Assigns a reserved IPv6 to a Droplet
`unassign`	Unassign a reserved IPv6 from a Droplet

Parameters

reserved_ipv6 string required

A reserved IPv6 address.

Min: 1

type string required

The type of action to initiate for the reserved IPv6.

One of: assign, unassign

droplet_id integer optional

Example: 758604968

The ID of the Droplet that the reserved IPv6 will be assigned to.

Request Sample

Show Request Sample

import os
from pydo import Client

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

req={
  "type": "unassign"
}

resp = client.reserved_ipv6s_actions.post(reserved_ipv6="2409:40d0:f7:1017:74b4:3a96:105e:4c6e", body=req)

Response Example

Show Response Example

{
  "action": {
    "id": 72531856,
    "status": "completed",
    "type": "assign_ip",
    "started_at": "2015-11-12T17:51:03Z",
    "completed_at": "2015-11-12T17:51:14Z",
    "resource_id": 758604968,
    "resource_type": "reserved_ipv6",
    "region": {
      "name": "New York 3",
      "slug": "nyc3",
      "sizes": [
        "s-1vcpu-1gb",
        "s-1vcpu-2gb",
        "s-1vcpu-3gb",
        "s-2vcpu-2gb",
        "s-3vcpu-1gb",
        "s-2vcpu-4gb",
        "s-4vcpu-8gb",
        "s-6vcpu-16gb",
        "s-8vcpu-32gb",
        "s-12vcpu-48gb",
        "s-16vcpu-64gb",
        "s-20vcpu-96gb",
        "s-24vcpu-128gb",
        "s-32vcpu-192gb"
      ],
      "features": [
        "private_networking",
        "backups",
        "ipv6",
        "metadata"
      ],
      "available": true
    },
    "region_slug": "nyc3"
  }
}

More Information

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