Skip to main content
To update an existing Box Hub, call the PUT /2.0/hubs/{hub_id} endpoint with the hub ID and the fields you want to change. You can update the title, description, AI settings, and collaboration restrictions.
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.

​
Update hub

curl -i -X PUT "https://api.box.com/2.0/hubs/HUB_ID" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "HR Hub",
       "description": "Updated description for HR policies and onboarding.",
       "is_ai_enabled": true
     }'
Replace HUB_ID with the actual hub ID. Request body fields are optional. Include only the fields you want to update.

​
Request body fields

FieldTypeRequiredDescription
titlestringNoTitle of the Box Hub. Maximum length is 50 characters.
descriptionstringNoDescription of the Box Hub.
is_ai_enabledbooleanNoWhether AI features are enabled for the hub.
is_collaboration_restricted_to_enterprisebooleanNoWhether collaboration is restricted to the enterprise.
A successful response returns the updated Hub object.