メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

POST /v1/files Qoder Cloud Agents プラットフォームにファイルをアップロードし、Session やツールから利用できるようにします。Content-Type: multipart/form-data を使用します。

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

​
リクエストボディ（multipart/form-data）

フィールド型必須説明
filefileはいアップロードするファイルのバイナリ内容
purposestringいいえファイル用途。値：user_upload、tool_output、skill_output、session_resource、agent_output。指定しない場合のデフォルトは user_upload
metadataJSON stringいいえカスタムメタデータ、JSON オブジェクト形式

​
リクエスト例

curl -X POST "https://openapi.qoder.sh/api/v1/cloud/files" \
  -H "Authorization: Bearer $QODER_PAT" \
  -F "file=@./my-document.txt" \
  -F "purpose=session_resource" \
  -F 'metadata={"project":"demo"}'

​
レスポンス例

HTTP 201 Created 
{
  "created_at": "2026-05-18T15:33:44Z",
  "file_id": "file_019e3bb8c1387743bf4ef115aae5acb1",
  "filename": "my-document.txt",
  "metadata": {
    "project": "demo"
  },
  "mime_type": "text/plain",
  "purpose": "session_resource",
  "size_bytes": 110,
  "status": "ready",
  "updated_at": "2026-05-18T15:33:44Z"
}

​
レスポンスフィールド

フィールド型説明
file_idstringファイル一意識別子、file_ プレフィックス
filenamestring元のファイル名
size_bytesintegerファイルサイズ（バイト）
mime_typestringMIME タイプ、サーバー側で自動検出
purposestringファイル用途
statusstringファイル状態、アップロード成功時は ready
metadataobjectカスタムメタデータ
created_atstring作成時刻（ISO 8601）
updated_atstring更新時刻（ISO 8601）

​
エラーレスポンス

HTTPtype説明
400invalid_request_errorfile フィールド欠落または purpose 値が無効
401—認証トークンが欠落または無効

​
エラー例

{
  "error": {
    "message": "Field 'file' is required.",
    "type": "invalid_request_error"
  },
  "type": "error"
}

{
  "error": {
    "message": "Field 'purpose' must be one of: user_upload, tool_output, skill_output, session_resource, agent_output.",
    "type": "invalid_request_error"
  },
  "type": "error"
}