---
title: "PostObject"
slug: "storage-archivestorage-postobject"
tags: ["Archive Storage"]
updated: 2026-09-17T10:12:27Z
published: 2026-09-17T10:12:27Z
canonical: "api.ncloud-docs.com/storage-archivestorage-postobject"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PostObject

Available in Classic and VPC

Set or change metadata of an object.

## Requests

The following describes the request format for the endpoint. The request format is as follows.

| Method | URI |
| --- | --- |
| POST | /v1/AUTH_{project_id}/{container}/{object} |

### Request headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Optional | Value of the issued token |
| `X-Object-Meta-{name}` | String | Optional | Metadata to set - Enter the key for the metadata in the `{name}` part - Enter the metadata value in the header value |
| `X-Delete-At` | Integer | Optional | Scheduled time for automatic deletion of the object (Unix timestamp) - Use when you want to temporarily store data - It deletes the object at the entered date and time |
| `X-Delete-After` | Integer | Optional | When to delete the object automatically (enter in seconds) - Use when you want to temporarily store data - It deletes the object after the entered time from the time of upload - It takes precedence when used concurrently with the `X-Delete-At` header |
| `Content-Disposition` | String | Optional | Browser's response handling method |
| `Content-Encoding` | String | Optional | Object's encoding method |
| `Content-Type` | String | Optional | Object's MIME type |

### Request path parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `project_id` | String | Required | Project ID - For more information on how to check the project ID, see [Archive Storage overview](/docs/en/storage-archivestorage#%EC%9D%B8%EC%A6%9D) |
| `container` | String | Required | Name of the container where the target object is stored |
| `object` | String | Required | Target object name |

### Request query parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bulk-delete` | String | Optional | Delete multiple objects and containers at once - Up to 10,000 can be requested - Enter the deletion target in the request body after entering the key |
| `extract-archive` | String | Optional | Upload compressed file - Enter the file extension to decompress as a value - Uploaded files are automatically unzipped and saved to a specified location |

### Request example

The following is a sample request.

```
curl -L -X POST 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Object-Meta-collection: C3' \
-H 'X-Delete-After: 3600' \
-H 'X-Object-Meta-Row: C3-A8'
```

## Responses

The following describes the response format.

### Response headers

For headers common to all Archive Storage APIs, see [Archive Storage common headers](/docs/en/storage-archivestorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94).

### Response status codes

The following describes the response status codes.

| HTTP status code | Code | Message | Description |
| --- | --- | --- | --- |
| 202 | - | Accepted | Request succeeded |

### Response example

The following is a sample response.

```
HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
X-Openstack-Request-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
Date: Mon, 17 Sep 2018 09:27:37 GMT
```