---
title: "Rename and Move an Object"
url: https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/stratus/rename-move/
description: "This page describes the method to execute circuits in your application with sample code snippets."
last_updated: 2026-09-09T10:45:38Z
service: CloudScale
type: general
related_links:
  - name: "Catalyst CloudScale"
    url: /en/cloud-scale/
  - name: "Stratus Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction/
  - name: "Java SDK Documentation"
    url: /en/sdk/java/v1/cloud-scale/stratus/rename-move-object/
  - name: "Python SDK Documentation"
    url: /en/sdk/python/v1/cloud-scale/stratus/rename-move-object/
  - name: "iOS SDK Documentation"
    url: /en/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK Documentation"
    url: /en/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK Documentation"
    url: /en/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API Documentation"
    url: /en/api/code-reference/cloud-scale/stratus/rename-object/#RenameObject
repository:
  name: "Repository"
  url: https://github.com/catalystbyzoho/zcatalyst-sdk-js
---

# Rename and Move Operations on an Object

> **Note:** Ensure you have installed the [required package](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/stratus/overview/#prerequisites) to use this SDK method.

#### Parameters Used

<table border="1" cellpadding="8" cellspacing="0">
  <thead>
    <tr>
      <th>Parameter Name</th>
      <th>Data Type</th>
      <th>Definition</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>`key`</td>
      <td>**String**</td>
      <td>The original name of the object that you need to rename or move.</td>
    </tr>
    <tr>
      <td>`destination`</td>
      <td>**String**</td>
      <td>The new name of the object, containing the complete path information.</td>
    </tr>
  </tbody>
</table>

> **Notes:**

* 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 copy the file to `pictures/kitten` path, then: 
    - `source_object` value will be '`pictures/puppy/kitten.png`'
    - `dest_object` value will be `'pictures/kitten/kitten.png'`

The `renameObject()` SDK method can be used for both *rename* and *move* operations. The `bucket` reference used in the following code snippet is the [component instance](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/stratus/create-bucket-instance/).

### Rename an Object

> **Notes:**

* 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.

* 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*.

```javascript
const res = await bucket.renameObject("sam/out/sample.txt", "sam/out/update_sample.txt");
console.log(res);
```

### Move an Object

> **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.

```javascript
const moveRes = await bucket.renameObject("sam/out/sample.txt", "out/sample.txt");
console.log(moveRes);
```

#### Example of Expected Response

```json
{
  "current_key": "sam/out/sample.txt",
  "message": "Rename successful",
  "rename_to": "sam/out/update_sample.txt"
}
```