Skip to main content
POST
/
files
/
upload
Error
A valid request URL is required to generate request examples
{
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "name": "product-photo.png",
  "size": 204800,
  "extension": "png",
  "mime_type": "image/png",
  "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/product-photo.png"
}

Authorizations

​
Authorization
string
header
required

API Key 認証です。すべての API リクエストにおいて、Authorization HTTP ヘッダーに Bearer プレフィックスを付けた API Key を含めてください。例：Authorization: Bearer {API_KEY}。API Key はサーバーサイドに保存し、クライアントサイドで共有・保存しないことを強く推奨します。API Key の漏洩は深刻な結果につながる可能性があります。

Body

multipart/form-data

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

​
file
file
required

アップロードするファイル。サポートされるタイプには画像、ドキュメント、音声、動画が含まれます。

​
user
string

ユーザー識別子。開発者のルールで定義され、アプリケーション内で一意である必要があります。

Response

ファイルが正常にアップロードされました。

​
id
string<uuid>

一意のファイル ID。

​
name
string

ファイル名。

​
size
integer

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

​
extension
string | null

ファイル拡張子。

​
mime_type
string | null

ファイルの MIME タイプ。

​
created_by
string<uuid> | null

ファイルをアップロードしたユーザーの ID。

​
created_at
integer<int64>

アップロードタイムスタンプ（Unix エポック秒）。

​
preview_url
string | null

ファイルのプレビュー URL。

​
source_url
string | null

ファイルのソース URL。

​
original_url
string | null

ファイルの元の URL。

​
user_id
string<uuid> | null

関連付けられたユーザーの ID。

​
tenant_id
string<uuid> | null

関連付けられたテナントの ID。

​
conversation_id
string<uuid> | null

関連付けられた会話の ID。

​
file_key
string | null

ファイルのストレージキー。