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/v1/{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 a new Earth Engine asset within a specified project or location.\u003c/p\u003e\n"],["\u003cp\u003eSupports creating folders, images, and image collections with specific data requirements.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eearthengine.assets.create\u003c/code\u003e IAM permission and an OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying a custom 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 outlines the process to create assets within a project. Users send a `POST` request to a specified URL, defining the asset's `parent` project. The request body includes asset details; the `assetId` and `overwrite` parameters are also settable. Asset types include `FOLDER`, `IMAGE`, and `IMAGE_COLLECTION`. `IMAGE` assets require `startTime`, `endTime`, `properties`, and a Cloud Storage URI. `IMAGE_COLLECTION` requires only `startTime`, `endTime`, and `properties`. Successful creation returns a new `EarthEngineAsset` instance, permissions required are `earthengine.assets.create`.\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/v1/{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/v1/projects.assets#EarthEngineAsset).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [EarthEngineAsset](/earth-engine/reference/rest/v1/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)."]]
