ローカルファイルをアップロード

一時停止中の人間の入力フォームにローカルファイルを 1 つアップロードします。

POST /form/human_input/files/upload

Error

A valid request URL is required to generate request examples

201

uploadSuccess

{
  "id": "1a77f0df-c0e6-461c-987c-e72526f341ee",
  "name": "draft-review.pdf",
  "size": 204800,
  "extension": "pdf",
  "mime_type": "application/pdf",
  "created_by": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "created_at": 1705407629,
  "preview_url": null,
  "source_url": null,
  "original_url": null,
  "user_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "tenant_id": "11223344-5566-7788-99aa-bbccddeeff00",
  "conversation_id": null,
  "file_key": "uploads/draft-review.pdf"
}

Authorizations

Authorization · string · header · required

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

Body

multipart/form-data

ファイルアップロードリクエスト。multipart/form-data が必要です。

file · file · required

アップロードするファイル。フォーム入力の allowed_file_types と allowed_file_extensions に従う必要があります。

Response

201

application/json

ファイルのアップロードに成功しました。

id · string

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

name · string

元のファイル名。

size · integer

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

extension · string | null

ファイル拡張子。

mime_type · string | null

ファイルの MIME タイプ。

created_by · string | null

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

created_at · integer<int64> | null

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

preview_url · string | null

ファイルプレビュー用の署名付き URL。生成されていない場合は null。

source_url · string | null

リモートから取得した場合の元のソース URL。ローカルアップロードの場合は null。

original_url · string | null

user_id · string | null

アップロードを所有するユーザーの識別子。

tenant_id · string | null

アップロードが属するテナント。

conversation_id · string | null

人間の入力のアップロードでは常に null。

file_key · string | null

内部ストレージキー。