# REST Resource: folders

- [Resource: Folder](https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders#Folder)
  - [JSON representation](https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders#Folder.SCHEMA_REPRESENTATION)
- [LifecycleState](https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders#LifecycleState)
- [Methods](https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders#METHODS_SUMMARY)

## Resource: Folder

A Folder in an Organization's resource hierarchy, used to organize that Organization's resources.

| JSON representation |
|---|
| ``` { "name": string, "parent": string, "displayName": string, "lifecycleState": enum (`https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders#LifecycleState`), "createTime": string, "tags": { string: string, ... }, "configuredCapabilities": [ string ], "managementProject": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the Folder. Its format is `folders/{folder_id}`, for example: "folders/1234". |
| `parent` | `string` Required. The Folder's parent's resource name. Updates to the folder's parent must be performed via `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/move#google.cloud.resourcemanager.v2.Folders.MoveFolder`. |
| `displayName` | `string` The folder's display name. A folder's display name must be unique amongst its siblings, e.g. no two folders with the same parent can share the same display name. The display name must start and end with a letter or digit, may contain letters, digits, spaces, hyphens and underscores and can be no longer than 30 characters. This is captured by the regular expression: `[\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?`. |
| `lifecycleState` | ``enum (`https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders#LifecycleState`)`` Output only. The lifecycle state of the folder. Updates to the lifecycleState must be performed via `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/delete#google.cloud.resourcemanager.v2.Folders.DeleteFolder` and `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/undelete#google.cloud.resourcemanager.v2.Folders.UndeleteFolder`. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Timestamp when the Folder was created. Assigned by the server. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `tags` | `map (key: string, value: string)` Optional. Input only. Immutable. Tag keys/values directly bound to this folder. Each item in the map must be expressed as " : ". For example: "123/environment" : "production", "123/costCenter" : "marketing" Note: Currently this field is in Preview. |
| `configuredCapabilities[]` | `string` Output only. Optional capabilities configured for this folder (via capabilities.patch API). Example: `folders/123/capabilities/app-management`. |
| `managementProject` | `string` Output only. Management Project associated with this folder (if app-management capability is enabled). Example: `projects/google-mp-123` OUTPUT ONLY. |

## LifecycleState

Folder lifecycle states.

| Enums ||
|---|---|
| `LIFECYCLE_STATE_UNSPECIFIED` | Unspecified state. |
| `ACTIVE` | The normal and active state. |
| `DELETE_REQUESTED` | The folder has been marked for deletion by the user. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/create` | Creates a Folder in the resource hierarchy. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/delete` | Requests deletion of a Folder. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/get` | Retrieves a Folder identified by the supplied resource name. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/getIamPolicy` | Gets the access control policy for a Folder. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/list` | Lists the Folders that are direct descendants of supplied parent resource. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/move` | Moves a Folder under a new resource parent. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/patch` | Updates a Folder, changing its display_name. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/search` | Search for folders that match specific filter criteria. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/setIamPolicy` | Sets the access control policy on a Folder, replacing any existing policy. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/testIamPermissions` | Returns permissions that a caller has on the specified Folder. |
| ### `https://docs.cloud.google.com/resource-manager/reference/rest/v2/folders/undelete` | Cancels the deletion request for a Folder. |