メインコンテンツへスキップ
POST
/
files
/
{file_id}
/
versions
/
current
cURL
curl -i -X POST "https://api.box.com/2.0/files/12345/versions/current" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "type": "file_version",
       "id": "456456"
     }'
{
  "id": "12345",
  "type": "file_version",
  "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
  "name": "tigers.jpeg",
  "size": 629644,
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00",
  "modified_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "trashed_at": "2012-12-12T10:53:43-08:00",
  "trashed_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "restored_at": "2012-12-12T10:53:43-08:00",
  "restored_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "purged_at": "2012-12-12T10:53:43-08:00",
  "uploader_display_name": "Ellis Wiggins",
  "version_number": "1"
}
このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
file_id
string
required

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

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

Query Parameters

​
fields
string[]

レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。

このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。

Body

application/json

昇格させるファイルバージョン。

​
id
string

ファイルバージョンID。

Example:

"11446498"

​
type
enum<string>

昇格させるタイプ。

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

"file_version"

Response

新しく作成されたファイルバージョンオブジェクトを返します。

任意のファイルバージョンAPIエンドポイントからデフォルトで返される可能性がある、ファイルバージョンのFull版の表示。 ファイルバージョンのStandard版の表示。 他のリソース内にネストされたときに使用されるファイルバージョンのMini版の表示。 最も基本的なファイルバージョンのBase版の表示。fieldsクエリパラメータを使用すると、最小限の数のフィールドが返されます。

​
id
string
required

ファイルバージョンを表す一意の識別子。

Example:

"12345"

​
type
enum<string>
required

値は常にfile_versionになります。

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

"file_version"

​
sha1
string

ファイルの現在のバージョンのSHA1ハッシュ。

Example:

"134b65991ed521fcfe4724b7d814ab8ded5185dc"

​
name
string

ファイルバージョンの名前。

Example:

"tigers.jpeg"

​
size
integer<int64>

ファイルバージョンのサイズ (バイト単位)。

Example:

629644

​
created_at
string<date-time>

ファイルバージョンオブジェクトが作成された日時。

Example:

"2012-12-12T10:53:43-08:00"

​
modified_at
string<date-time>

ファイルバージョンオブジェクトが最後に更新された日時。

Example:

"2012-12-12T10:53:43-08:00"

​
modified_by
ユーザー (Mini) · object

ファイルバージョンを最後に更新したユーザー。

​
trashed_at
string<date-time> | null

ファイルバージョンオブジェクトがごみ箱に移動された日時。

Example:

"2012-12-12T10:53:43-08:00"

​
trashed_by
ユーザー (Mini) · object

ファイルバージョンをごみ箱に移動したユーザー。

​
restored_at
string<date-time> | null

ファイルバージョンがごみ箱から復元された日時。

Example:

"2012-12-12T10:53:43-08:00"

​
restored_by
ユーザー (Mini) · object

ごみ箱からファイルバージョンを復元したユーザー。

​
purged_at
string<date-time> | null

ファイルバージョンオブジェクトが完全に削除される日時。

Example:

"2012-12-12T10:53:43-08:00"

​
uploader_display_name
string

ファイルをアップロードしたユーザーの表示名。ほとんどの場合、これはアップロード時点でログインしているユーザーの名前です。

このファイルのアップロードに、ユーザーに対してメールアドレスの入力を要求するファイルリクエストフォームが使用された場合、このフィールドにはそのメールアドレスが設定されます。メールアドレスがファイルリクエストフォームで要求されなかった場合、このフィールドは、File Requestという値を返すように設定されます。

メールアドレスが指定されなかったその他すべての匿名のケースでは、このフィールドの値がデフォルトでSomeoneになります。

Example:

"Ellis Wiggins"

​
version_number
string

このファイルバージョンのバージョン番号。

Example:

"1"