---
title: "Rename and Move Operations on an Object"
url: https://docs.catalyst.zoho.com/en/sdk/java/v1/cloud-scale/stratus/rename-move-object/
description: "This page lists the Java SDK method to perform rename and move operations on an object."
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction
  - name: "JavaScript SDK Documentation"
    url: /en/sdk/javascript/v1/cloudscale/stratus/rename-move/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/stratus/rename-move-object/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /en/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Rename and Move Operations on an Object

To rename and to move an object, we will be using the same `renameObject()` SDK method.

### Rename an Object

Using the `renameObject()` SDK method you can rename objects present in a bucket.

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

> **Note:** The following characters including space are not supported when you create a path or an object: double quote, both angular brackets, hashtag, backward slash and pipe symbol.

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
			<th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>The original name of the object that you need to rename</td>
		</tr>
		<tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>The new name that you rename the object with</td>
		</tr>
	</tbody>
</table>

#### Sample Code Snippet 

**Package Imports**

```java
import org.json.simple.JSONObject;
```

```java
JSONObject res = bucket.renameObject("sam/out/sample.txt", "sam/out/update_sample.txt"); 
System.out.println(res);
```

> **Note:** You cannot rename objects in a bucket that has [Versioning](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) enabled.

### Move an Object

Using the `renameObject()` SDK method, we can move the object from one path to another within a bucket.

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
			<th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>The complete name and [path](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/#path) of the object that you are required to move.</td>
		</tr>
		<tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>The complete name and new path of the object.</td>
		</tr>
	</tbody>
</table>

> **Note:** 

* You need to provide the complete object name, along with the [**path**](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/#path) for both `key` and `destination` values.

* For example, if you have file named "`kitten.png`" in the path `pictures/puppy`, and you need to move the file to `pictures/kitten` path, then: 

`key` value will be '`pictures/puppy/kitten.png`'

`destination` value will be '`pictures/kitten/kitten.png`'

#### Sample Code Snippet 

**Package Imports**

```java
import org.json.simple.JSONObject;
```

```java
JSONObject res = bucket.renameObject("sam/out/sample.txt", "output/sample.txt"); 
System.out.println(res);
```

> **Note:** You cannot perform move operations in a bucket that has [Versioning](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) enabled.