The Folder resource represents a
[folder](https://docs.cloud.google.com/storage/docs/folders-overview.md.txt) in a
Cloud Storage bucket with [hierarchical namespace](https://docs.cloud.google.com/storage/docs/hns-overview.md.txt) enabled.

To try out the methods for this resource, see [Methods](https://docs.cloud.google.com/storage/docs/json_api/v1/folders.md.txt#methods).

## Resource representations

<br />

```yaml
{
  "kind": "storage#folder"
  "id": string,
  "selfLink": string,
  "name": string,
  "bucket": string,
  "createTime": datetime,
  "updateTime": datetime,
  "metageneration": long
}
```

| Property name | Value | Description | Notes |
|---|---|---|---|
| `kind` | `string` | The kind of item this is. For folders, this is always `storage#folder`. |   |
| `id` | `string` | The ID of the folder, which is composed of the bucket name and folder name, expressed as a path. For example, `example-bucket/example-folder1/example-folder2/`. |   |
| `selfLink` | `string` | The canonical URL of the folder. For example, `https://www.googleapis.com/storage/v1/b/example-bucket/folders/example-folder1/example-folder2/`. |   |
| `name` | `string` | The name of the folder, expressed as a path. For example, `example-folder1/example-folder2/`. |   |
| `bucket` | `string` | The name of the bucket that contains the folder. |   |
| `createTime` | `datetime` | The time at which the folder was created, in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339). |   |
| `updateTime` | `datetime` | The time at which the folder's metadata was last updated, in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339). |   |
| `metageneration` | `long` | The metadata generation of the folder. |   |

## Methods

[delete](https://docs.cloud.google.com/storage/docs/json_api/v1/folders/delete.md.txt)
:   Delete a folder.

[get](https://docs.cloud.google.com/storage/docs/json_api/v1/folders/getfoldermetadata.md.txt)
:   Get the metadata of a folder.

[insert](https://docs.cloud.google.com/storage/docs/json_api/v1/folders/insert.md.txt)
:   Create a folder.

[list](https://docs.cloud.google.com/storage/docs/json_api/v1/folders/list.md.txt)
:   Retrieves a list of folders matching the criteria.

[rename](https://docs.cloud.google.com/storage/docs/json_api/v1/folders/rename.md.txt)
:   Rename a folder.

For information about status and error codes returned by these APIs, see the
[reference page](https://docs.cloud.google.com/storage/docs/json_api/v1/status-codes.md.txt).