pydo.images.post_account_transfer_create()
Generated on 7 May 2026
from pydo version
v0.34.0
Description
To initiate an account transfer for an image, send a POST request to
/v2/images/$IMAGE_ID/account_transfer.
Only snapshot images may be transferred by this endpoint to another account.
An image account transfer always has exactly one recipient, specified in the request body. The recipient can be one of the following:
-
A DigitalOcean account, denoted by
recipient_emailin the request body. The recipient will receive an email with instructions to accept the transfer. Once the recipient accepts the transfer, the image will be moved to their account. -
A DigitalOcean team, denoted by
recipient_uuidin the request body. If the user has sufficient permissions in the recipient team, the transfer will be automatically accepted and the image will be moved to the recipient team’s account. Otherwise, the transfer will be pending until a user with sufficient permissions in the recipient team accepts the transfer.
Parameters
| Name | Type | Required | Description | Default Value |
|---|---|---|---|---|
image_id |
integer | True | A unique number that can be used to identify and reference a specific image. | |
body |
JSON or IO[bytes] | True |
More Information
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.