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.
GET /v1/files/{file_id}
ファイル ID を指定して単一ファイルの詳細メタデータ情報を取得します。
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|
| Authorization | はい | Bearer $QODER_PAT |
パスパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|
file_id | string | はい | ファイル一意識別子、file_ プレフィックス文字列 |
リクエスト例
curl -X GET "https://openapi.qoder.sh/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1" \
-H "Authorization: Bearer $QODER_PAT"
レスポンス例
HTTP 200 OK
{
"created_at": "2026-05-18T15:33:44Z",
"file_id": "file_019e3bb8c1387743bf4ef115aae5acb1",
"filename": "qoder-test-upload.txt",
"metadata": {},
"mime_type": "text/plain",
"purpose": "session_resource",
"size_bytes": 110,
"status": "ready",
"updated_at": "2026-05-18T15:33:44Z"
}
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|
file_id | string | ファイル一意識別子 |
filename | string | 元のファイル名 |
size_bytes | integer | ファイルサイズ（バイト） |
mime_type | string | MIME タイプ |
purpose | string | ファイル用途 |
status | string | ファイル状態（ready は利用可能を表す） |
metadata | object | カスタムメタデータ |
created_at | string | 作成時刻（ISO 8601） |
updated_at | string | 更新時刻（ISO 8601） |
エラーレスポンス
| HTTP | type | 説明 |
|---|
| 401 | — | 認証トークンが欠落または無効 |
| 404 | not_found_error | 指定 ID のファイルが存在しない |
エラー例
{
"error": {
"message": "File 'file_nonexistent123' was not found.",
"type": "not_found_error"
},
"type": "error"
}
