Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
Method: projects.assets.move
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
POST https://earthengine.googleapis.com/v1/{sourceName=projects/*/assets/**}:move
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
sourceName |
string
The name of the asset to move. name is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT").
Authorization requires the following IAM permission on the specified resource sourceName:
earthengine.assets.delete
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"destinationName": string
} |
| Fields |
destinationName |
string
The destination name to which to move the asset. name is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT").
Authorization requires the following IAM permission on the specified resource destinationName:
earthengine.assets.create
|
Response body
If successful, the response body contains an 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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eMoves an Earth Engine asset from a source location to a specified destination.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permissions for both source (delete) and destination (create) locations.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the destination name in the format "projects/*/assets/**".\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003ePOST\u003c/code\u003e method with the URL \u003ccode\u003ehttps://earthengine.googleapis.com/v1/{sourceName=projects/*/assets/**}:move\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses return an \u003ccode\u003eEarthEngineAsset\u003c/code\u003e object.\u003c/p\u003e\n"]]],["This outlines how to move an asset using a POST request to a specified URL. The `sourceName` path parameter indicates the asset to be moved and requires `earthengine.assets.delete` IAM permission. The `destinationName` in the request body specifies the new location, requiring `earthengine.assets.create` IAM permission. Both source and destination names follow a format of \"projects/*/assets/**\". Successful operations return an `EarthEngineAsset`. Authentication needs one of the stated OAuth scopes.\n"],null,["# Method: projects.assets.move\n\nMoves an asset.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{sourceName=projects/*/assets/**}:move`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `sourceName` | `string` The name of the asset to move. `name` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `sourceName`: - `earthengine.assets.delete` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------|\n| ``` { \"destinationName\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `destinationName` | `string` The destination name to which to move the asset. `name` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `destinationName`: - `earthengine.assets.create` |\n\n### Response body\n\nIf successful, the response body contains an 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)."]]