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/v1beta/{parent=projects/*}/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 and properties using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eSupports creating folders, images, and image collections with specific requirements for each type.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with appropriate IAM permissions and OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying an asset ID and optional overwriting of existing image assets.\u003c/p\u003e\n"],["\u003cp\u003eReturns the newly created EarthEngineAsset upon successful completion.\u003c/p\u003e\n"]]],["This documentation details how to create assets within a project using a `POST` request to the specified URL. Assets can be of type `FOLDER`, `IMAGE`, or `IMAGE_COLLECTION`. `IMAGE` assets require a single Cloud Storage URI, while `FOLDER` assets do not have other specified fields. `IMAGE_COLLECTION` only specifies `startTime`, `endTime`, and `properties`. The request needs authorization with specific IAM permissions and requires parameters `parent`, `assetId`, and optionally `overwrite`. The response is the newly created asset.\n"],null,["# Method: projects.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/v1beta/{parent=projects/*}/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/v1beta/projects.assets#EarthEngineAsset).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [EarthEngineAsset](/earth-engine/reference/rest/v1beta/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)."]]
