AI-generated Key Takeaways
-
The provided content details the process of copying an asset using an HTTP POST request to a specified URL.
-
The request requires a
sourceNamepath parameter specifying the asset to copy, formatted as "projects/*/assets/**". -
The request body includes
destinationName(the new asset name) and an optionaloverwriteboolean field. -
Successful requests return an instance of
EarthEngineAsset. -
Authorization for this action requires specific IAM permissions on both the source and destination assets and one of two OAuth scopes.
Copies an asset.
HTTP request
POST https://earthengine.googleapis.com/v1beta/{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 .

