Box Developerドキュメント
ログイン

BoxWorks 2024でコンテンツとAIの可能性について紹介します。

最新バージョン

ファイルバージョンを削除

delete
https://api.box.com/2.0
/files/:file_id/versions/:file_version_id

このエンドポイントはバージョン2024.0です。引き続き使用するために 変更は必要ありません。詳細については、 **Box APIのバージョン管理**を参照してください。

特定のファイルバージョンをごみ箱に移動します。

バージョンが追跡されるのは、プレミアムアカウントを持つBoxユーザーのファイルに関してのみです。

リクエスト

bearer [ACCESS_TOKEN]
application/json

リクエストヘッダー

stringヘッダー内省略可能
1

変更を加える前にこの項目が最近変更されていないことを確認します。

その項目の最後に認識されたetag値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは412 Precondition Failedを返して失敗します。

パスパラメータ

stringパス内必須
12345

ファイルを表す一意の識別子。

ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_idは123です。

stringパス内必須
1234

ファイルバージョンのID。

レスポンス

none

ファイルが正常に削除された場合は、空のレスポンスを返します。

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

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

delete
ファイルバージョンを削除
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

Box SDKのバージョン戦略の詳細については、 **こちら**を確認してください。


cURL
curl -i -X DELETE "https://api.box.com/2.0/files/12345/versions/456456" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
Node/TypeScript v10
await client.fileVersions.deleteFileVersionById(file.id, fileVersion.id);
Python v10
client.file_versions.delete_file_version_by_id(file.id, file_version.id)
.NET v10
await client.FileVersions.DeleteFileVersionByIdAsync(fileId: file.Id, fileVersionId: fileVersion.Id);
Swift v10
try await client.fileVersions.deleteFileVersionById(fileId: file.id, fileVersionId: fileVersion.id)
Java v10
client.getFileVersions().deleteFileVersionById(file.getId(), fileVersion.getId())
.NET v6
await client.FileVersions.DeleteFileVersionByIdAsync(fileId: file.Id, fileVersionId: fileVersion.Id);
Node v4
await client.fileVersions.deleteFileVersionById(file.id, fileVersion.id);