Method: projects.locations.registrations.initiatePushTransfer

Initiates the Push Transfer process to transfer the domain to another registrar. The process might complete instantly or might require confirmation or additional work. Check the emails sent to the email address of the registrant. The process is aborted after a timeout if it's not completed.

This method is only supported for domains that have the REQUIRE_PUSH_TRANSFER property in the list of domainProperties. The domain must also be unlocked before it can be transferred to a different registrar.

For more information, see Transfer a registered domain to another registrar.

HTTP request

POST https://domains.googleapis.com/v1/{registration=projects/*/locations/*/registrations/*}:initiatePushTransfer

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
registration

string

Required. The name of the Registration for which the push transfer is initiated, in the format projects/*/locations/*/registrations/*.

Authorization requires the following IAM permission on the specified resource registration:

  • domains.registrations.configureManagement

Request body

The request body contains data with the following structure:

JSON representation
{
  "tag": string
}
Fields
tag

string

Required. The Tag of the new registrar. Can be found at List of registrars.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.