---
title: "Update Folder"
method: PUT
path: "/datainsights/v1.1/folders/{id}"
tags: ["Folders"]
---

# Update Folder

`PUT /datainsights/v1.1/folders/{id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Folders give the ability to the user to organize and find better their reports.

**Notes**
- A Folder can not have the same name.
- A Folder may have a parent or may not.
- A Folder can not have as parent_id himself.
- The max level of nested folders is 3. Below there is an example of the max level allowed.

```
Financial
│
└───Bar
    │
    └───Food

```

## Path parameters

- `id` integer, required

## Headers

- `X-PROPERTY-ID` integer, required

## Request body

- Folder
  - `id` integer, required: Folder Id
  - `name` string, required: Folder Name
  - `description` string: Folder description
  - `parent_id` integer, nullable, required: Id of the Parent Folder

## Response `200`

OK

- Folder
  - `id` integer, required: Folder Id
  - `name` string, required: Folder Name
  - `description` string: Folder description
  - `parent_id` integer, nullable, required: Id of the Parent Folder

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/cloudbeds/apis/data-insights-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/data-insights-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/data-insights-api/revisions/0a16807149c2?raw)