---
title: "Edit Item Folder"
method: PATCH
path: "/api/v1/item_folders/{item_folder_id}"
---

# Edit Item Folder

`PATCH /api/v1/item_folders/{item_folder_id}`

## Request

- Base URL: `https://app.workramp.com`
- URL: `https://app.workramp.com/api/v1/item_folders/{item_folder_id}`
- Auth: API key in header `Authorization`

Edit a single item folder

## Path parameters

- `item_folder_id` string, required

## Request body

- object
  - `name` string: Name of the item folder
  - `ui_order` integer: UI order of the item folder
  - `is_hidden` boolean: Hidden state of the item folder
  - `is_locked` boolean: Locked state of the item folder
  - `permissions` object: User/group permissions
    - `groups` string: Group ID keys => role values. Valid roles are: - full_editor - limited_editor - edit - assign - read
    - `users` string: User ID keys => role values. Valid roles are: - full_editor - limited_editor - edit - assign - read

## Response `200`

---

[API](https://skmtc.dev/workramp/apis/json-api.md) - [All operations](https://skmtc.dev/workramp/apis/json-api/llms.txt) - [OpenAPI document](https://skmtc.dev/workramp/apis/json-api/revisions/2cb77bf12793?raw)
