# REST Resource: projects.locations.folders

- [Resource: Folder](https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders#Folder)
  - [JSON representation](https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders#Folder.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders#METHODS_SUMMARY)

## Resource: Folder

Represents a Dataform Folder. This is a resource that is used to organize Files and other Folders and provide hierarchical access controls.

| JSON representation |
|---|
| ``` { "name": string, "displayName": string, "containingFolder": string, "teamFolderName": string, "createTime": string, "updateTime": string, "internalMetadata": string, "creatorIamPrincipal": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The Folder's name. |
| `displayName` | `string` Required. The Folder's user-friendly name. |
| `containingFolder` | `string` Optional. The containing Folder resource name. This should take the format: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, or just "" if this is a root Folder. This field can only be updated through folders.move. |
| `teamFolderName` | `string` Output only. The resource name of the TeamFolder that this Folder is associated with. This should take the format: projects/{project}/locations/{location}/teamFolders/{teamFolder}. If this is not set, the Folder is not associated with a TeamFolder and is a UserFolder. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp of when the Folder was created. 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"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp of when the Folder was last updated. 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"`. |
| `internalMetadata` | `string` Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. |
| `creatorIamPrincipal` | `string` Output only. The IAM principal identifier of the creator of the Folder. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/create` | Creates a new Folder in a given project and location. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/delete` | Deletes a single Folder. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/deleteTree` | Deletes a Folder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs). |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/get` | Fetches a single Folder. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/getIamPolicy` | Gets the access control policy for a resource. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/move` | Moves a Folder to a new Folder, TeamFolder, or the root location. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/patch` | Updates a single Folder. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/queryFolderContents` | Returns the contents of a given Folder. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/setIamPolicy` | Sets the access control policy on the specified resource. |
| ### `https://docs.cloud.google.com/dataform/reference/rest/v1/projects.locations.folders/testIamPermissions` | Returns permissions that a caller has on the specified resource. |