Add the power of the Box AI API to your custom apps at Content Cloud Summit on May 15

Learn more and register!

Event source

The source file or folder that triggered an event in the event stream.

The object containing classification information for the item that triggered the event. This field will not appear if the item does not have a classification set.

Top Secret

The classification's name


The unique identifier that represents the item.


The name of the item.


The type of the item that the event represents. Can be file or folder.

Value is one of file,folder

The user who owns this item.

The optional folder that this folder is located within.

This value may be null for some folders such as the root folder or the trash folder.

Response Example

  "classification": {
    "name": "Top Secret"
  "item_id": "560284318361",
  "item_name": "report.pdf",
  "item_type": "file",
  "owned_by": {
    "id": "11446498",
    "type": "user",
    "login": "",
    "name": "Aaron Levie"
  "parent": {
    "id": "12345",
    "type": "folder",
    "etag": "1",
    "name": "Contracts",
    "sequence_id": "3"