---
title: "Update a folder by ID"
method: PUT
path: "/folders/{folder_id}"
tags: ["Folder"]
---

# Update a folder by ID

`PUT /folders/{folder_id}`

Use this endpoint to upadate a specific folder by ID.

## Path parameters

- `folder_id` integer, required

## Headers

- `x-oneflow-api-token` string, required
- `x-oneflow-user-email` string, email

## Request body

- object — Request body to update a folder.
  - `name` string, required — The folder's name.

## Response `200`

Returned an updated folder.

- object — A folder.
  - `_permissions` object, required — This attribute contains the permissions for various operations possible on the folders.
    - `folder:contract` boolean, required
    - `folder:delete` boolean, required
    - `folder:sub_folder:create` boolean, required
    - `folder:update` boolean, required
  - `id` integer, required — Folder ID
  - `name` string, required — Folder name.
  - `parent_id` integer, nullable, required — If exist any parent folder, its ID.
  - `path` integer[], required — An array of folder IDs representing the path from the top of the hierarchy to the current folder.
  - `workspace_id` integer, required — workspace ID

## Other responses

- `400` — Invalid format or content of the request.
- `401` — The API token or the user email is invalid.
- `403` — The request is not authorized by the server.
- `404` — A required entity is missing.

---

[API](https://skmtc.net/oneflow/apis/public-api-for-oneflow.md) · [All operations](https://skmtc.net/oneflow/apis/public-api-for-oneflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneflow/public-api-for-oneflow/versions/0e73a45dec15/schema)