Stay organized with collectionsSave and categorize content based on your preferences.
Creates an asset.
The following asset types are createable: *FOLDER: No fields inassetmay be specified. *IMAGE: To create a COG-backed asset, useimage.importExternalinstead. Seehttps://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotifffor more details. *IMAGE_COLLECTION: Only the fieldsstartTime,endTime, andpropertiesmay be specified.
HTTP request
POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/assets
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eCreates an Earth Engine asset with the specified type (FOLDER, IMAGE, or IMAGE_COLLECTION) and properties.\u003c/p\u003e\n"],["\u003cp\u003eRequires appropriate IAM permissions to create assets within the specified parent project or location.\u003c/p\u003e\n"],["\u003cp\u003eAllows for setting a custom asset ID and optionally overwriting existing image assets.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an EarthEngineAsset object with asset details.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required using either the \u003ccode\u003eearthengine\u003c/code\u003e or \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes how to create assets within a project using a POST request to the Earth Engine API. The `parent` path parameter is required, and asset type determines specifiable fields. `FOLDER` assets have no fields, while `IMAGE` and `IMAGE_COLLECTION` are limited to `startTime`, `endTime`, and `properties`; with images also allowing for `cloudStorageLocation`. Optional query parameters `assetId` and `overwrite` are available. The request body uses `EarthEngineAsset`, and successful creation returns a new `EarthEngineAsset` instance. Requires OAuth scopes for authorization.\n"],null,["# Method: projects.locations.assets.create\n\nCreates an asset.\n\nThe 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 \u003chttps://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff\u003e for more details. \\* `IMAGE_COLLECTION`: Only the fields `startTime`, `endTime`, and `properties` may be specified.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/assets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the asset collection (e.g., \"projects/\\*\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `parent`: - `earthengine.assets.create` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `assetId` | `string` The ID of the asset to create. Equivalent to name but without the \"projects/\\*/assets\" (e.g., users/\\[USER\\]/\\[ASSET\\]). |\n| `overwrite` | `boolean` Whether to allow overwriting an image asset. |\n\n### Request body\n\nThe request body contains an instance of [EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
