Method: projects.locations.assets.create

  • Creates an Earth Engine asset with the specified type (FOLDER, IMAGE, or IMAGE_COLLECTION) and properties.

  • Requires appropriate IAM permissions to create assets within the specified parent project or location.

  • Allows for setting a custom asset ID and optionally overwriting existing image assets.

  • The request body must contain an EarthEngineAsset object with asset details.

  • Authentication is required using either the earthengine or cloud-platform OAuth scope.

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/v1alpha/{parent=projects/*/locations/*}/assets

The URL uses gRPC Transcoding syntax.

Path parameters

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

string

The ID of the asset to create. Equivalent to name but without the "projects/*/assets" (e.g., users/[USER]/[ASSET]).
overwrite

boolean

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.