Box Developer Documentation
Log in

Join BoxWorks 2024 to discover what's possible with content and AI!

Register now!

File version (Full)

A full representation of a file version, as can be returned from any file version API endpoints by default

This resource has a few variations that can be encountered when using the API.

The fields that are part of the full variant can be returned by API endpoints that support the fields parameter. For example, by defining the fields request parameter as id,type when requesting a file by ID, only those fields will be returned in the API response.

string
12345

The unique identifier that represent a file version.

string
file_version

file_version

Value is always file_version

string (date-time)
2012-12-12T10:53:43-08:00

When the file version object was created

string (date-time)
2012-12-12T10:53:43-08:00

When the file version object was last updated

User (Mini) object

The user who last updated the file version

string
tigers.jpeg

The name of the file version

string (date-time)
2012-12-12T10:53:43-08:00

When the file version object will be permanently deleted.

string (date-time)
2012-12-12T10:53:43-08:00

When the file version was restored from the trash.

User (Mini) object

The user who restored the file version from the trash.

string
134b65991ed521fcfe4724b7d814ab8ded5185dc

The SHA1 hash of this version of the file.

integer (int64)
629644

Size of the file version in bytes

string (date-time)
2012-12-12T10:53:43-08:00

When the file version object was trashed.

User (Mini) object

The user who trashed the file version

string
Ellis Wiggins

The display name of the user that uploaded the file. In most cases this is the name of the user logged in at the time of the upload.

If the file was uploaded using a File Request form that requires the user to provide an email address, this field is populated with that email address. If an email address was not required in the File Request form, this field is set to return a value of File Request.

In all other anonymous cases where no email was provided this field will default to a value of Someone.

string
1

The version number of this file version

Response Example

{
  "id": "12345",
  "type": "file_version",
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00",
  "modified_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "name": "tigers.jpeg",
  "purged_at": "2012-12-12T10:53:43-08:00",
  "restored_at": "2012-12-12T10:53:43-08:00",
  "restored_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
  "size": 629644,
  "trashed_at": "2012-12-12T10:53:43-08:00",
  "trashed_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "uploader_display_name": "Ellis Wiggins",
  "version_number": "1"
}