Box Hubs - Box Dev Docs

Box Hubs provide a centralized way to organize content for specific teams, departments, or projects within your organization. They serve as content portals that bring together files, folders, and web links in a structured, easily accessible manner. Box Hubs are integrated with Box AI, allowing for more accurate responses thanks to a narrowed context window. The Box Hubs API lets you programmatically manage Box Hubs, their content, and collaborations. There are three groups of endpoints:

Box Hubs: Create, get, list, update, delete, and copy hubs.
Box Hub items: List items in a hub and add or remove files, folders, and web links.
Box Hub collaborations: Create, list, get, update, and delete hub collaborations to control who can access a hub and at what level.

Box Hubs endpoints require the box-version: 2025.0 header. If you omit this header, the API returns a 400 error with the message Missing required box-version header. Supported API versions: [2025.0]. For more information, see Box API versioning strategy.

Enable Box Hubs

To enable Box Hubs (including the API) for your enterprise, follow the Configuring Box Hubs product guide.

Prerequisites

A Box account with Box Hubs enabled for your enterprise.
An access token with the appropriate scopes for the operations you need (for example, for listing enterprise hubs, Global Content Manager (GCM) for admins or Hub Co-admins).

Next steps

Create a hub — Create a new Box Hub through the API.
Get a hub — Retrieve a hub by ID.
List hubs — List hubs for a user or for the enterprise.
Update a hub — Change a hub’s title, description, or settings.
Delete a hub — Delete a single hub.
Copy a hub — Create a copy of an existing hub.
Manage hub items — List, add, and remove items in a hub.
Manage hub collaborations — Invite users or groups and manage their access to a hub.

​Enable Box Hubs

​Prerequisites

​Next steps

Enable Box Hubs

Prerequisites

Next steps