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/*/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 properties, including its type (FOLDER, IMAGE, or IMAGE_COLLECTION) and associated data.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either the \u003ccode\u003eearthengine\u003c/code\u003e or \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the specified URL, with path and query parameters to define the asset's parent and ID.\u003c/p\u003e\n"],["\u003cp\u003eAllows for specifying start and end times, properties, and Cloud Storage location (for IMAGE type) within the request body.\u003c/p\u003e\n"],["\u003cp\u003eOptionally allows overwriting an existing image asset using the \u003ccode\u003eoverwrite\u003c/code\u003e query parameter.\u003c/p\u003e\n"]]],["This API endpoint facilitates the creation of assets within a specified project. The `POST` request to the `/assets` endpoint requires the `parent` path parameter, defining the project, and an asset ID. Asset types include `FOLDER`, `IMAGE`, and `IMAGE_COLLECTION`, each with specific field restrictions. `IMAGE` assets must specify `cloudStorageLocation` with a Cloud Storage URI. The `overwrite` query parameter allows replacing existing image assets. Successful creation returns a new `EarthEngineAsset` instance. Authorization requires specific IAM permissions and OAuth scopes.\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/v1beta/{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/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)."]]
