---
updatedAt: 2026-06-05T11:09:11.000Z
---

# Update the Folder

Update name of a specific folder.

> 📘 URL: PUT/api/v1/folders/:folderId

\_**Note:**\_The contents of the restored folder are not automatically restored. The contents (subfolders and creatives) must each be restored individually.

# Path Parameters

| Parameter | Description                                        | Type   | Required | Possible Values   |
| :-------- | :------------------------------------------------- | :----- | :------- | :---------------- |
| folderId  | ID of the folder where new folder is to be created | string | N        | A valid folder ID |

# Request Parameters

[block:parameters]
{
  "data": {
    "h-0": "Parameter",
    "h-1": "Description",
    "h-2": "Type",
    "h-3": "Required",
    "h-4": "Possible Values",
    "0-0": "advertiserId",
    "0-1": "The ID of the specific advertiser",
    "0-2": "integer",
    "0-3": "Y",
    "0-4": "A valid advertisers ID",
    "1-0": "name",
    "1-1": "Name of folder",
    "1-2": "string",
    "1-3": "Y",
    "1-4": "Valid name  \n***Note:*** The maximum length of the name is 255 characters"
  },
  "cols": 5,
  "rows": 2,
  "align": [
    "left",
    "left",
    "left",
    "left",
    "left"
  ]
}
[/block]

# Headers

| Header Name              | Description                                                                                                                                    | Required | Values                                                                                                                                           |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Authorization            | The token will provide you the access to the API. It is same for all advertisers you access through the API.                                   | Y        | Please utilize the generated `auth_token` shared with you at the time of partner onboarding from the Getting Started Guide                       |
| Content-Type             | Format of the message body                                                                                                                     | Y        | application/json                                                                                                                                 |
| WM\_CONSUMER.ID          | Unique ID for consumer. We will provide you the consumer ID to access the API. It is same for all advertisers you access   through the API.    | Y        | Please use the generated `ConsumerId` shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information |
| WM\_SEC.AUTH\_SIGNATURE  | Signature for authentication                                                                                                                   | Y        | Use the signature generator code from Getting Started Guide to generate this value                                                               |
| WM\_SEC.KEY\_VERSION     | Key version. We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API.            | Y        | 1                                                                                                                                                |
| WM\_CONSUMER.intimestamp | Timestamp for  which the auth signature is generated. Use Unix epoch format for the timestamp.                                                 | Y        | Use the signature generator code from Getting Started Guide to generate this value                                                               |

## Sample Request

```
curl -X PUT \
'https://developer.api.us.stg.walmart.com/api-proxy/service/display/api/v1/api/v1/folders/e02a09b2-1e3c-2g22-bf47-8a123c35002a '  \

--header 'Content-Type:  application/json'  \ 
--header 'Authorization: Bearer <auth_token>'
--header 'WM_SEC.AUTH_SIGNATURE: **************'  \ 
--header 'WM_SEC.KEY_VERSION: 1'  \ 
--header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff'  \ 
--header 'WM_CONSUMER.intimestamp: 1565309779'

--data 
     {
        "advertiserId": 123,   
        "name": "New Folder Name" 
     }
```

# Response

[block:parameters]
{
  "data": {
    "h-0": "Element",
    "h-1": "Description",
    "h-2": "Type",
    "0-0": "code",
    "0-1": "The response code can have following values:<ul><li>success</li><li>failure</li></ul><br>Click [here](/advertising-partners/docs/api-status-codes-and-errors)  for more information about Status Codes and Errors",
    "0-2": "string",
    "1-0": "details",
    "1-1": "Details of the error if the response code is `failure`",
    "1-2": "string",
    "2-0": "folderId",
    "2-1": "ID of the folder",
    "2-2": "string"
  },
  "cols": 3,
  "rows": 3,
  "align": [
    "left",
    "left",
    "left"
  ]
}
[/block]

## Sample Response

```
[  
    {  
        "code": "success",  
        "details": ["success"],  
        "folderId": "e02a09b2-1e3c-2g22-bf47-8a123c35002a" 
    } 
]
```