Box Developer Documentation

Comment

This resource is used by enpoints in the version 2024.0. For more details, see Box API versioning.

Standard representation of a comment.

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

The fields that are part of the standard variant are generally returned when the resource is requested via its own API endpoints. For example, when retrieving a file by ID, it will return these fields unless the fields parameter has been specified.

string
11446498

The unique identifier for this comment.

string
comment

The value will always be comment.

Value is always comment

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

The time this comment was created.

A mini user object representing the author of the comment.

true

Whether or not this comment is a reply to another comment.

object

The file this comment was placed on.

string
11446498

The unique identifier for this object.

string
file

The type for this object.

string
@Aaron Levie these tigers are cool!

The text of the comment, as provided by the user.

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

The time this comment was last modified.

Response Example

{
  "id": "11446498",
  "type": "comment",
  "created_at": "2012-12-12T10:53:43-08:00",
  "created_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "is_reply_comment": true,
  "item": {
    "id": "11446498",
    "type": "file"
  },
  "message": "@Aaron Levie these tigers are cool!",
  "modified_at": "2012-12-12T10:53:43-08:00"
}