Folders

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gcp-cloud-storage/json-schema/gcp-cloud-storage-folders-schema.json",
  "title": "Folders",
  "description": "A list of folders.",
  "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/Folders",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "The list of items.",
      "items": {
        "$ref": "#/$defs/Folder"
      }
    },
    "kind": {
      "type": "string",
      "description": "The kind of item this is. For lists of folders, this is always storage#folders.",
      "default": "storage#folders"
    },
    "nextPageToken": {
      "type": "string",
      "description": "The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results."
    }
  },
  "$defs": {
    "Folder": {
      "type": "object",
      "description": "A folder. Only available in buckets with hierarchical namespace enabled.",
      "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."
            }
          }
        }
      }
    }
  }
}