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

# Update a folder

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

## 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.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)