Skip to main content
To create a copy of an existing Box Hub, call the POST /2.0/hubs/{hub_id}/copy endpoint with the source hub ID and optional new title and description. The original hub is not modified.
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.

Copy hub

curl -i -X POST "https://api.box.com/2.0/hubs/HUB_ID/copy" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "HR Hub (Copy)",
       "description": "Copy of the HR hub for a new region."
     }'
Replace HUB_ID with the source hub ID. Request body fields are optional. If you omit the title parameter, the API uses a default one. A successful response returns the new Hub object.

Request body fields

FieldTypeRequiredDescription
titlestringNoTitle for the new hub. Maximum length is 50 characters.
descriptionstringNoDescription for the new hub.