メインコンテンツへスキップ
PUT
/
hub_collaborations
/
{hub_collaboration_id}
cURL
curl --request PUT \
  --url https://api.box.com/2.0/hub_collaborations/{hub_collaboration_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'box-version: <box-version>' \
  --data '
{
  "role": "editor"
}
'
{
  "id": "12345678",
  "type": "hub_collaboration",
  "hub": {
    "id": "12345",
    "type": "hubs"
  },
  "accessible_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "role": "editor",
  "status": "accepted",
  "acceptance_requirements_status": {
    "terms_of_service_requirement": {
      "is_accepted": true,
      "terms_of_service": {
        "id": "11446498",
        "type": "terms_of_service"
      }
    },
    "strong_password_requirement": {
      "enterprise_has_strong_password_required_for_external_users": true,
      "user_has_strong_password": true
    },
    "two_factor_authentication_requirement": {
      "enterprise_has_two_factor_auth_enabled": true,
      "user_has_two_factor_authentication_enabled": true
    }
  }
}
「Box SDKのバージョニング戦略について詳しく学ぶ。」

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
box-version
enum<string>
required

Version header.

利用可能なオプション:
2025.0

Path Parameters

​
hub_collaboration_id
string
required

HubコラボレーションのID。

Body

application/json

既存のBox Hubコラボレーションを更新するためのリクエスト本文。

​
role
string

Box Hubに付与されるアクセスレベル。使用可能な値はeditor、viewer、co-ownerです。

Example:

"editor"

Response

更新されたBox Hubコラボレーションオブジェクトを返します。

Box Hubコラボレーションオブジェクトは、特定のロールによって定義される権限を含んだBox Hubへのアクセス権限をユーザーまたはグループに付与します。

​
id
string
required

このコラボレーションの一意の識別子。

Example:

"12345678"

​
type
enum<string>
required

値は常にhub_collaborationになります。

利用可能なオプション:
hub_collaboration
Example:

"hub_collaboration"

​
hub
Box Hub (Base) · object

最も基本的なBox HubのBase版の表示。

​
accessible_by
Box Hubにアクセスできるユーザー · object

アクセス権限が付与されるユーザーまたはグループ。 ユーザーのMini版の表示は、ステータスがpendingの場合にのみ返すことができます。 他のリソース内にネストされたときに使用されるユーザーのMini版の表示。

​
role
string

Box Hubに付与されるアクセスレベル。使用可能な値はeditor、viewer、co-ownerです。

Example:

"editor"

​
status
enum<string>

コラボレーション招待のステータス。ステータスがpendingの場合、loginとnameは空の文字列を返します。

利用可能なオプション:
accepted,
pending,
rejected
Example:

"accepted"

​
acceptance_requirements_status
object