Box Developer Documentation
Log in

Item

A generic representation of a file, folder, user or enterprise

string
1

The entity tag of this item. Used with If-Match headers. May be null for some folders such as root or trash.

string
11446498

The unique identifier for this object

string
Pictures

The name of the item.

string
3

A numeric identifier that represents the most recent user event that has been applied to this item.

This can be used in combination with the GET /events-endpoint to filter out user events that would have occurred before this identifier was read.

An example would be where a Box Drive-like application would fetch an item via the API, and then listen to incoming user events for changes to the item. The application would ignore any user events where the sequence_id in the event is smaller than or equal to the sequence_id in the originally fetched resource.

string
file

The type of this item

Value is one of file,folder,web_link

string
https://www.example.com/example/1234

The URL this item points to

Response Example

{
  "etag": 1,
  "id": 11446498,
  "name": "Pictures",
  "sequence_id": 3,
  "type": "file",
  "url": "https://www.example.com/example/1234"
}