AI-generated Key Takeaways
-
The primary function of this endpoint is to copy an asset.
-
The HTTP request method is POST to a URL using gRPC Transcoding syntax.
-
The
sourceNamepath parameter specifies the asset to copy and requires theearthengine.assets.getIAM permission. -
The request body includes
destinationNamefor the copy's location, requiringearthengine.assets.createpermission, and an optionaloverwriteboolean field. -
A successful response returns an instance of EarthEngineAsset and requires specific OAuth scopes for authorization.
Copies an asset.
HTTP request
POST https://earthengine.googleapis.com/v1alpha/{sourceName=projects/*/assets/**}:copy
The URL uses gRPC Transcoding syntax.
Path parameters
sourceName
string
The name of the asset to copy. name
is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT"). (e.g., "assets/users/[USER]/[ASSET]").
Authorization requires the following IAM
permission on the specified resource sourceName
:
-
earthengine.assets.get
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "destinationName" : string , "overwrite" : boolean } |
destinationName
string
The destination name to which to copy the asset. name
is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT").
Authorization requires the following IAM
permission on the specified resource destinationName
:
-
earthengine.assets.create
overwrite
boolean
Whether to allow overwriting an existing asset.
Response body
If successful, the response body contains an instance of EarthEngineAsset
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/earthengine -
https://www.googleapis.com/auth/cloud-platform
For more information, see the OAuth 2.0 Overview .

