---
title: "Update a folder."
method: PUT
path: "/v2/content/folders/{id}"
tags: ["folderManagement"]
---

# Update a folder.

`PUT /v2/content/folders/{id}`

Update an existing folder with the given identifier. Set the header parameter `isAdminMode` to `"true"` if updating a folder inside "Admin Recommended" folder.

## Path parameters

- `id` string, required

## Headers

- `isAdminMode` string

## Request body

- UpdateFolderRequest
  - `name` string, required — The name of the folder.
  - `description` string — The description of the folder.

## Response `200`

The folder was successfully updated.

- Folder
  - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
  - `createdBy` string, required — Identifier of the user who created the resource.
  - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
  - `modifiedBy` string, required — Identifier of the user who last modified the resource.
  - `id` string, required — Identifier of the content item.
  - `name` string, required — The name of the content item.
  - `itemType` string, required — Type of the content item. Supported values are: 1. Folder 2. Search 3. Report (for old dashboards) 4. Dashboard (for new dashboards) 5. Lookups
  - `parentId` string, required — Identifier of the parent content item.
  - `permissions` string[], required — List of permissions the user has on the content item.
  - `description` string — The description of the folder.
  - `isScheduled` boolean — Indicates whether the content item refers to scheduled search. This field is only relevant to `Search` content type.
  - `children` Content[] — A list of the content items.
    - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
    - `createdBy` string, required — Identifier of the user who created the resource.
    - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
    - `modifiedBy` string, required — Identifier of the user who last modified the resource.
    - `id` string, required — Identifier of the content item.
    - `name` string, required — The name of the content item.
    - `itemType` string, required — Type of the content item. Supported values are: 1. Folder 2. Search 3. Report (for old dashboards) 4. Dashboard (for new dashboards) 5. Lookups
    - `parentId` string, required — Identifier of the parent content item.
    - `permissions` string[], required — List of permissions the user has on the content item.
    - `description` string — Description of the content item.
    - `isScheduled` boolean — Indicates whether the content item refers to scheduled search. This field is only relevant to `Search` content type.

## Other responses

- `default` — The operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/versions/18a824df1e78/schema)