---
title: "Update a folder"
method: PATCH
path: "/directory/v1/folder/{id}"
tags: ["Directory (Sites)"]
---

# Update a folder

`PATCH /directory/v1/folder/{id}`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/directory/v1/folder/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- S12DirectoryV1DirectoryUpdateFolderPropertiesBody: The parameters for `UpdateFolderPropertiesRequest`
  - `name` S12DirectoryV1UpdateFolderPropertiesRequestFolderName
    - `val` string
  - `domain` string: domain represents the type/domain/hierarchy for the folder. This is used for changing the properties of a specific domain folder

## Response `200`

A successful response.

- S12DirectoryV1UpdateFolderPropertiesResponse: Result returned from `UpdateFolderPropertiesResponse`
  - `folder` S12DirectoryV1Folder: Folder represents the main directory object
    - `id` string: An unique identifier for the folder. Must be a valid UUID. For example: '00001d65-d336-485a-8331-7b53f37e8f51'
    - `name` string: Name associated with folder
    - `org_id` string: The organisation that the folder belongs to
    - `creator_id` string: The user id responsible for creating the folder For example: 'user_5441fffcde344415bb7ccaceda27e196'
    - `created_at` string, date-time: The creation timestamp of the folder (Date, Time, Timezone) For example: '2020-04-28T04:14:31:00Z'
    - `modified_at` string, date-time: The timestamp of the last modification for the folder (Date, Time, Timezone) For example: '2020-04-28T04:14:00Z'
    - `meta_label` string: Additional meta information that can be associated with the folder e.g. 'location'
    - `members_count` integer: The number of users with a direct association of type 'MEMBER' for the folder
    - `deleted` boolean: Whether a folder has been marked as deleted or not.

## Other responses

- `default`: An unexpected error response.

---

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