Box Developerドキュメント
ログイン
ベータ

Hubの項目を管理

post
https://api.box.com/2.0
/hubs/:hub_id/manage_items

HubからHubの項目を追加または削除します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

リクエストヘッダー

stringヘッダー内必須

Version header.

次の値に固定: 2025.0

パスパラメータ

stringパス内必須
12345

Hubを表す一意の識別子。

HubのIDを確認するには、ウェブアプリでこのHubにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/hubs/123の場合、hub_idは123です。

リクエスト本文

object array本文内省略可能

Hubの項目に対して実行する操作のリスト。

string本文内条件付きで必須
"add"

Hubの項目に対して実行する操作。

次の値のいずれか1つ: add,remove

object object本文内

Hubに追加できる項目への参照。

レスポンス

application/jsonHubの項目の管理のレスポンス

すべての操作のステータスを取得します。

application/jsonクライアントエラー

Authorizationヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。

application/jsonクライアントエラー

Hubが見つからない場合、またはユーザーにHubへのアクセス権限が与えられていない場合に返されます。

application/jsonクライアントエラー

予期しないクライアントエラー。

post
Hubの項目を管理
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

TypeScript Gen
await client.hubItems.manageHubItemsV2025R0(createdHub.id, {
  operations: [
    {
      action: 'add' as HubItemOperationV2025R0ActionField,
      item: new FolderReferenceV2025R0({ id: folder.id }),
    } satisfies HubItemOperationV2025R0,
  ],
} satisfies HubItemsManageRequestV2025R0);
Python Gen
client.hub_items.manage_hub_items_v2025_r0(
    created_hub.id,
    operations=[
        HubItemOperationV2025R0(
            action=HubItemOperationV2025R0ActionField.ADD,
            item=FolderReferenceV2025R0(id=folder.id),
        )
    ],
)
.NET Gen
await client.HubItems.ManageHubItemsV2025R0Async(hubId: createdHub.Id, requestBody: new HubItemsManageRequestV2025R0() { Operations = Array.AsReadOnly(new [] {new HubItemOperationV2025R0(action: HubItemOperationV2025R0ActionField.Add, item: new FolderReferenceV2025R0(id: folder.Id))}) });

レスポンスの例

{
  "operations": [
    {
      "action": "add",
      "error": "Item not found",
      "item": {
        "id": "42037322",
        "type": "file"
      },
      "status": 200
    }
  ]
}