Box Developer Documentation
Log in

Hub

A standard representation of a hub, as returned from any hubs 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 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
12345

The unique identifier that represent a hub.

The ID for any hub can be determined by visiting a hub in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/hubs/123 the hub_id is 123.

string
hubs

The value will always be hubs.

Value is always hubs

boolean
true

Indicates if non-owners can invite others to the hub.

boolean
true

Indicates if a shared link can be created for the hub.

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

The date and time when the folder was created. This value may be null for some folders such as the root folder or the trash folder.

object

The user who created this hub.

string
11446498

The unique identifier for this user.

string
user

The value will always be user.

Value is always user

string (email)

The primary email address of this user.

string
Aaron Levie
50

The display name of this user.

string
All the contracts for the company.

The description of the hub. First 200 characters are returned.

boolean
true

Indicates if AI features are enabled for the hub.

boolean
true

Indicates if collaboration is restricted to the enterprise.

string
Contracts

The title given to the hub.

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

The date and time when the hub was last updated.

object

The user who last modified this hub.

string
11446498

The unique identifier for this user.

string
user

The value will always be user.

Value is always user

string (email)

The primary email address of this user.

string
Aaron Levie
50

The display name of this user.

integer (int32)
506

The number of views for the hub.

Response Example

{
  "id": "12345",
  "type": "hubs",
  "can_non_owners_invite": true,
  "can_shared_link_be_created": true,
  "created_at": "2012-12-12T10:53:43Z",
  "created_by": {
    "id": "11446498",
    "type": "user",
    "login": "[email protected]",
    "name": "Aaron Levie"
  },
  "description": "All the contracts for the company.",
  "is_ai_enabled": true,
  "is_collaboration_restricted_to_enterprise": true,
  "title": "Contracts",
  "updated_at": "2012-12-12T10:53:43Z",
  "updated_by": {
    "id": "11446498",
    "type": "user",
    "login": "[email protected]",
    "name": "Aaron Levie"
  },
  "view_count": 506
}
OSZAR »