Folder

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gcp-cloud-storage/json-schema/gcp-cloud-storage-folder-schema.json",
  "title": "Folder",
  "description": "A folder. Only available in buckets with hierarchical namespace enabled.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/gcp-cloud-storage-folders-api-openapi.yml#/components/schemas/Folder",
  "type": "object",
  "properties": {
    "bucket": {
      "type": "string",
      "description": "The name of the bucket containing this folder."
    },
    "id": {
      "type": "string",
      "description": "The ID of the folder, including the bucket name, folder name."
    },
    "kind": {
      "type": "string",
      "description": "The kind of item this is. For folders, this is always storage#folder.",
      "default": "storage#folder"
    },
    "metageneration": {
      "type": "string",
      "description": "The version of the metadata for this folder. Used for preconditions and for detecting changes in metadata.",
      "format": "int64"
    },
    "name": {
      "type": "string",
      "description": "The name of the folder. Required if not specified by URL parameter."
    },
    "selfLink": {
      "type": "string",
      "description": "The link to this folder."
    },
    "createTime": {
      "type": "string",
      "description": "The creation time of the folder in RFC 3339 format.",
      "format": "date-time"
    },
    "updateTime": {
      "type": "string",
      "description": "The modification time of the folder metadata in RFC 3339 format.",
      "format": "date-time"
    },
    "pendingRenameInfo": {
      "type": "object",
      "description": "Only present if the folder is part of an ongoing rename folder operation. Contains information which can be used to query the operation status.",
      "properties": {
        "operationId": {
          "type": "string",
          "description": "The ID of the rename folder operation."
        }
      }
    }
  }
}