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_email in 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_uuid in 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.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.