Join us on May 20th for the Content + AI Virtual Summit. Register now
curl -i -X POST "https://api.box.com/2.0/file_requests/42037322/copy" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"title": "Please upload required documents",
"description": "Please upload required documents",
"status": "active",
"is_email_required": true,
"is_description_required": false,
"folder": {
"id": "2233212",
"type": "folder"
}
}'{
"id": "42037322",
"type": "file_request",
"folder": {
"id": "12345",
"type": "folder",
"etag": "1",
"sequence_id": "3",
"name": "Contracts"
},
"created_at": "2020-09-28T10:53:43-08:00",
"updated_at": "2020-09-28T10:53:43-08:00",
"title": "Please upload documents",
"description": "Following documents are requested for your process",
"status": "active",
"is_email_required": true,
"is_description_required": true,
"expires_at": "2020-09-28T10:53:43-08:00",
"url": "/f/19e57f40ace247278a8e3d336678c64a",
"etag": "1",
"created_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"updated_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
}
}ファイルリクエストをコピー
あるフォルダにすでに存在する既存のファイルリクエストをコピーし、別のフォルダに適用します。
curl -i -X POST "https://api.box.com/2.0/file_requests/42037322/copy" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"title": "Please upload required documents",
"description": "Please upload required documents",
"status": "active",
"is_email_required": true,
"is_description_required": false,
"folder": {
"id": "2233212",
"type": "folder"
}
}'{
"id": "42037322",
"type": "file_request",
"folder": {
"id": "12345",
"type": "folder",
"etag": "1",
"sequence_id": "3",
"name": "Contracts"
},
"created_at": "2020-09-28T10:53:43-08:00",
"updated_at": "2020-09-28T10:53:43-08:00",
"title": "Please upload documents",
"description": "Following documents are requested for your process",
"status": "active",
"is_email_required": true,
"is_description_required": true,
"expires_at": "2020-09-28T10:53:43-08:00",
"url": "/f/19e57f40ace247278a8e3d336678c64a",
"etag": "1",
"created_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"updated_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
}
}Documentation Index
Fetch the complete documentation index at: https://developer.box.com/llms.txt
Use this file to discover all available pages before exploring further.
承認
The access token received from the authorization server in the OAuth 2.0 flow.
パスパラメータ
ファイルリクエストを表す一意の識別子。
ファイルリクエストのIDを確認するには、ウェブアプリケーションでファイルリクエストの作成画面にアクセスして、そのURLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/filerequest/123の場合、file_request_idは123です。
ボディ
ファイルリクエストをコピーするためのリクエスト本文。
新しいファイルリクエストを関連付けるフォルダ。
Show child attributes
Show child attributes
ファイルリクエストの新しいタイトル (省略可)。これを使用して、ファイルリクエストのタイトルを変更できます。
デフォルトでは、既存のファイルリクエストの値になります。
"Please upload required documents"
ファイルリクエストの新しい説明 (省略可)。これを使用して、ファイルリクエストの説明を変更できます。
デフォルトでは、既存のファイルリクエストの値になります。
"Please upload required documents"
ファイルリクエストの新しいステータス (省略可)。
このステータスをinactiveに設定すると、ファイルリクエストでは新しい送信を受け付けなくなり、ファイルリクエストのURLにアクセスした場合はHTTP 404ステータスコードが返されます。
デフォルトでは、既存のファイルリクエストの値になります。
active, inactive "active"
ファイルリクエストの送信者に、メールアドレスの指定を義務付けるかどうか。
これをtrueに設定すると、Box UIのファイルリクエストフォームにメールフィールドが表示されます。
デフォルトでは、既存のファイルリクエストの値になります。
true
ファイルリクエストの送信者に、送信するファイルの説明の指定を義務付けるかどうか。
これをtrueに設定すると、Box UIのファイルリクエストフォームに説明フィールドが表示されます。
デフォルトでは、既存のファイルリクエストの値になります。
true
ファイルリクエストが新しい送信を受け付けなくなる日付。
この日付を過ぎると、statusは自動的にinactiveに設定されます。
デフォルトでは、既存のファイルリクエストの値になります。
"2020-09-28T10:53:43-08:00"
レスポンス
更新されたファイルリクエストオブジェクトを返します。
任意のファイルリクエストAPIエンドポイントからデフォルトで返されるファイルリクエストのStandard版の表示。
このファイルリクエストの一意の識別子。
"42037322"
値は常にfile_requestになります。
file_request "file_request"
このファイルリクエストが関連付けられているフォルダ。
ファイルリクエストフォームを使用して送信されたファイルは、このフォルダにアップロードされます。
Show child attributes
Show child attributes
ファイルリクエストが作成された日時。
"2020-09-28T10:53:43-08:00"
ファイルリクエストが最後に更新された日時。
"2020-09-28T10:53:43-08:00"
ファイルリクエストのタイトル。これは、Box UIで、ファイルをアップロードしているユーザーに表示されます。
デフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストのタイトルになります。
"Please upload documents"
このファイルリクエストの説明 (省略可)。これは、Box UIで、ファイルをアップロードしているユーザーに表示されます。
デフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストの説明になります。
"Following documents are requested for your process"
ファイルリクエストのステータス。デフォルトではactiveになります。
このステータスをinactiveに設定すると、ファイルリクエストでは新しい送信を受け付けなくなり、ファイルリクエストのURLにアクセスした場合はHTTP 404ステータスコードが返されます。
デフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストのステータスになります。
active, inactive "active"
ファイルリクエストの送信者に、メールアドレスの指定を義務付けるかどうか。
これをtrueに設定すると、Box UIのファイルリクエストフォームにメールフィールドが表示されます。
デフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストの設定になります。
true
ファイルリクエストの送信者に、送信するファイルの説明の指定を義務付けるかどうか。
これをtrueに設定すると、Box UIのファイルリクエストフォームに説明フィールドが表示されます。
デフォルトでは、このファイルリクエストを作成するためにコピーされたファイルリクエストの設定になります。
true
ファイルリクエストが新しい送信を受け付けなくなる日付。
この日付を過ぎると、statusは自動的にinactiveに設定されます。
"2020-09-28T10:53:43-08:00"
このファイルリクエストに対して生成されたURL。このURLをユーザーと共有すると、ユーザーが関連付けられたフォルダにファイルをアップロードできるようになります。
"/f/19e57f40ace247278a8e3d336678c64a"
このファイルのHTTP etag。これは、ファイルリクエストの更新時にIf-Matchヘッダーと組み合わせて使用できます。そのヘッダーを指定すると、If-Matchヘッダーで指定されたetagとファイルリクエストのetagがまだ一致している場合のみ、ファイルリクエストが変更されます。
"1"
このファイルリクエストを作成したユーザー。
Show child attributes
Show child attributes
このファイルリクエストを最後に変更したユーザー。
Show child attributes
Show child attributes
このページは役に立ちましたか？