リモートファイルをアップロード

リモート URL を取得し、得られたファイルを一時停止中の人間の入力フォームに添付します。

POST /form/human_input/files/remote-upload

Error

A valid request URL is required to generate request examples

201

uploadSuccess

{
  "id": "1a77f0df-c0e6-461c-987c-e72526f341ee",
  "name": "report.pdf",
  "size": 204800,
  "extension": "pdf",
  "url": "https://files.example.com/signed/report.pdf?sig=abc123",
  "mime_type": "application/pdf",
  "created_by": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "created_at": 1705407629
}

Authorizations

Authorization · string · header · required

人間の入力フォームへのファイル添付に使う短期のアップロードトークン。アップロードトークンを発行 エンドポイントから取得し、 Authorization: Bearer hitl_upload_{token} の形式で渡します。

Body

application/json

url · string<uri> · required

取得して添付するファイルの、公開アクセス可能な URL。

Response

201

application/json

リモートファイルの取得と添付に成功しました。

id · string

人間の入力フォームを送信 エンドポイントの file および file-list 入力で、この値を upload_file_id として参照します。

name · string

リモート URL またはレスポンスヘッダから導出されたファイル名。

size · integer

ファイルサイズ（バイト）。

extension · string | null

ファイル拡張子。

url · string | null

ファイル内容を取得するための署名付き URL。

mime_type · string | null

ファイルの MIME タイプ。

created_by · string | null

ファイルのアップロード対象ユーザーの識別子。

created_at · integer<int64> | null

ファイル作成時の Unix タイムスタンプ（秒）。