AI-generated Key Takeaways
-
You can create
FOLDER,IMAGE, andIMAGE_COLLECTIONasset types. -
Asset creation requires a POST request to
https://earthengine.googleapis.com/v1beta/{parent=projects/*}/assets. -
The request requires a
parentpath parameter and can includeassetIdandoverwritequery parameters. -
The request body should contain an instance of
EarthEngineAsset, and the response body will return a newly created instance ofEarthEngineAsseton success. -
Authorization for asset creation requires specific IAM permissions and one of the listed OAuth scopes.
Creates an asset.
The following asset types are createable: * FOLDER
: No fields in asset
may be specified. * IMAGE
: To create a COG-backed asset, use image.importExternal
instead. See https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff
for more details. * IMAGE_COLLECTION
: Only the fields startTime
, endTime
, and properties
may be specified.
HTTP request
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/assets
The URL uses gRPC Transcoding syntax.
Path parameters
parent
string
Required. The parent of the asset collection (e.g., "projects/*").
Authorization requires the following IAM
permission on the specified resource parent
:
-
earthengine.assets.create
Query parameters
| Parameters | |
|---|---|
assetId
|
The ID of the asset to create. Equivalent to name but without the "projects/*/assets" (e.g., users/[USER]/[ASSET]). |
overwrite
|
Whether to allow overwriting an image asset. |
Request body
The request body contains an instance of EarthEngineAsset
.
Response body
If successful, the response body contains a newly created 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 .

