Backblaze · Schema

FileInfo

Information about a stored file

Cloud StorageObject StorageStorageBackup

Properties

Name	Type	Description
fileId	string	The unique identifier for this version of this file
fileName	string	The name of the file
accountId	string	The account that owns the file
bucketId	string	The bucket that the file is in
contentLength	integer	The size of the file in bytes
contentSha1	string	The SHA1 checksum of the bytes in the file
contentType	string	The MIME type of the file
fileInfo	object	Custom information about the file
action	string	The action that created this file version
uploadTimestamp	integer	Milliseconds since midnight, January 1, 1970 UTC

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/backblaze/refs/heads/main/json-schema/b2-native-api-file-info-schema.json",
  "title": "FileInfo",
  "description": "Information about a stored file",
  "type": "object",
  "properties": {
    "fileId": {
      "type": "string",
      "description": "The unique identifier for this version of this file",
      "example": "4_h4a48fe8875c6214145260818"
    },
    "fileName": {
      "type": "string",
      "description": "The name of the file",
      "example": "photos/image.jpg"
    },
    "accountId": {
      "type": "string",
      "description": "The account that owns the file",
      "example": "abc123def456"
    },
    "bucketId": {
      "type": "string",
      "description": "The bucket that the file is in",
      "example": "e73ede9969c64355ef8b"
    },
    "contentLength": {
      "type": "integer",
      "description": "The size of the file in bytes",
      "example": 102400
    },
    "contentSha1": {
      "type": "string",
      "description": "The SHA1 checksum of the bytes in the file",
      "example": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
    },
    "contentType": {
      "type": "string",
      "description": "The MIME type of the file",
      "example": "image/jpeg"
    },
    "fileInfo": {
      "type": "object",
      "description": "Custom information about the file"
    },
    "action": {
      "type": "string",
      "enum": [
        "upload",
        "hide",
        "start",
        "copy"
      ],
      "description": "The action that created this file version",
      "example": "upload"
    },
    "uploadTimestamp": {
      "type": "integer",
      "description": "Milliseconds since midnight, January 1, 1970 UTC",
      "example": 1660000000000
    }
  }
}