> For the complete documentation index, see [llms.txt](https://docs.coldstack.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/object/renameobject.md).

# RenameObject

Renames an object. This operation is an extension to the standard S3 protocol, and was implemented to give users far more functionality.

### Request <a href="#request" id="request"></a>

```http
MOVE /{bucket}/{key} HTTP/1.1
Destination: {newObjectKey}
X-ColdStack-Prefix: IsPrefix
```

#### Path parameters <a href="#path-parameters" id="path-parameters"></a>

| Parameter      | Description                                   |
| -------------- | --------------------------------------------- |
| `bucket`       | Name of the bucket.                           |
| `key`          | Current key of the object.                    |
| `newObjectKey` | New key for the object.                       |
| `IsPrefix`     | For renaming prefixes (e.g. renaming folders) |

#### Headings <a href="#request-headers" id="request-headers"></a>

Use only [generic headers](/http-api-compatible-with-amazon-s3/api-reference/common-request-headers.md) in your request .

### Response <a href="#response" id="response"></a>

#### Headings <a href="#response-headers" id="response-headers"></a>

The response can only contain [general headers](/http-api-compatible-with-amazon-s3/api-reference/common-response-headers.md) .

#### Response codes <a href="#response-codes" id="response-codes"></a>

For a list of possible responses, see the [Responses](/http-api-compatible-with-amazon-s3/api-reference/answers.md) section .

A successful response does not contain additional data and means that the object was successfully renamed.