エラー

すべてのエラーは同じ形式です。code は安定しておりコードで扱うためのものです。message は存在する場合、人が読むための説明であり、変更される可能性があります。

{
    "status": "error",
    "code": "UPGRADE_REQUIRED",
    "message": "Custom metadata is available on Pro and Enterprise plans only."
}

再試行は 429 と 5xx の場合のみ、バックオフを入れて行ってください。429 以外のすべての 4xx は、リクエスト自体を変更する必要があることを意味します。

認証と制限

コード	HTTP	意味
`ACCESS_DENIED`	401	認証情報がないか、認識されませんでした。
`PERMISSION_DENIED`	401	この操作には有効な有料プランが必要ですが、アカウントにありません。
`MISSING_SCOPE`	403	API キーにこのルートに必要なスコープがありません。認証を参照してください。
`RESOURCE_NOT_ALLOWED`	403	API キーが特定のアプリケーションに制限されています。
`UPLOAD_TOKEN_NOT_ALLOWED`	403	アップロードトークンはアップロードルートでのみ機能します。
`UPLOAD_TOKEN_USED`	401	アップロードトークンの使用回数が残っていません。期限切れのトークンは `ACCESS_DENIED` を返します。
`ACCOUNT_BLOCKED`	403	アカウントはファイルの保存をブロックされています。サポートにお問い合わせください。
`UPGRADE_REQUIRED`	403	このオプションはご利用のプランに含まれていません。`message` でそれを利用できるプランが示されます。
`RATE_LIMIT`	429	アカウント全体の API 枠を使い切ったか、IP が無効な認証情報を送信しすぎました。
`RATE_LIMITED`	429	このルート固有の制限に達しました。待ってから再試行してください。

オブジェクト

コード	HTTP	意味
`INVALID_OBJECT`	400	オブジェクト id の形式が正しくないか、あなたのものではありません。
`INVALID_OBJECT_NAME`	400	`name` が許可されたパターン (1〜128 文字) に一致しません。
`INVALID_OBJECT_PREFIX`	400	`prefix` が許可されたパターンに一致しません。
`INVALID_OBJECT_EXPIRE`	400	`expire` が有効な期間 (1 時間〜1825 日) ではありません。
`INVALID_OBJECT_PRIVATE`	400	`private` が `true` または `false` ではありません。
`INVALID_OBJECT_SECURITY_HASH`	400	`security_hash` がブール値ではないか、プライベートオブジェクトで `false` になっています。
`INVALID_OBJECT_OVERWRITE`	400	`overwrite` が `true` または `false` ではありません。
`INVALID_OBJECT_DISPOSITION`	400	`disposition` が `inline` または `attachment` ではありません。
`INVALID_OBJECT_CACHE_CONTROL`	400	`cache_control` が `immutable`、`no-cache`、`max-age=60..31536000` のいずれでもありません。
`INVALID_OBJECT_METADATA`	400	`metadata` の形式が正しくないか、予約済みのキーを使用しているか、5 キーまたは 512 バイトを超えています。
`INVALID_STORAGE_AUTO_DOWNLOAD`	400	`auto_download` が `true` または `false` ではありません。
`INVALID_CHECKSUM`	400	`checksum_sha256` が小文字 16 進数 64 文字ではありません。
`CHECKSUM_MISMATCH`	400	ファイルが `checksum_sha256` と一致しません。何も保存されていません。
`INVALID_DESTINATION`	400	コピーの `destination` の形式が正しくありません。
`SAME_OBJECT`	400	コピー元とコピー先が同じオブジェクトです。
`NOTHING_TO_UPDATE`	400	リクエストはどのフィールドも変更しません。
`INVALID_CONTINUATION_TOKEN`	400	一覧の `cursor` の形式が正しくないか、有効期限が切れています。カーソルなしで最初からやり直してください。
`TOO_MANY_OBJECTS`	400	1 回のリクエストに含まれるオブジェクトが多すぎます (削除は 100、更新は 50)。
`PREFIX_NOT_ALLOWED`	403	アップロードトークンは別のプレフィックスに紐付けられています。
`OBJECT_NOT_FOUND`	404	オブジェクトが存在しません。
`OBJECT_ALREADY_EXISTS`	409	この id のオブジェクトが存在し、`overwrite` が `false` です。
`OBJECT_IS_LEGACY`	オブジェクトごと	オブジェクトの更新の `results` で返されます。オブジェクトは2026年9月のアップデート以前に保存されたレガシーファイルで、ヘッダーを変更する前にオブジェクトのコピー (`move: true`) で移動する必要があります。
`VISIBILITY_CHANGE_FAILED`	オブジェクトごと	オブジェクトの更新の `results` で返されます: オブジェクトをプライベートにできず、公開されたままです。再試行してください。
`UPDATE_FAILED` / `COPY_FAILED` / `DELETE_FAILED`	500	操作に失敗しました。再試行してください。

アップロード

コード	HTTP	意味
`INVALID_CONTENT_TYPE`	409	オブジェクトのアップロードは、ファイルをちょうど 1 つ含む `multipart/form-data` のみを受け付けます。
`INVALID_FILE`	400	ファイルパートがないか、読み取れません。
`INVALID_FILE_TYPE`	400	ファイル拡張子の形式が正しくないか、長すぎます。
`BLOCKED_FILE_TYPE`	400	実行ファイルとインストーラーは受け付けられません。
`FILE_TYPE_NOT_ALLOWED`	400	アップロードトークンまたはプレフィックスのルールがこの拡張子を許可していません。
`FILE_TOO_SMALL`	400	ファイルは 512 バイト以上である必要があります。
`FILE_TOO_LARGE`	413	1 回のリクエストで 100 MB を超えた (チャンクアップロードを使用してください) か、プラン、トークン、またはルールで許可されたサイズを超えています。
`STORAGE_QUOTA_EXCEEDED`	403	アカウントが含まれるストレージの上限に達しました。
`TOO_MANY_CONCURRENT_UPLOADS`	429	このアカウントではすでに 4 件のアップロードが実行中です。
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	ストレージが一時的に利用できません。再試行してください。
`UPLOAD_FAILED`	500	アップロードに失敗しました。再試行してください。

チャンクアップロード

コード	HTTP	意味
`INVALID_UPLOAD_TOKEN`	400	`upload` トークンがないか、形式が正しくないか、あなたのものではありません。
`INVALID_CHUNK_PART`	400	`part` が 1〜2048 の整数ではありません。
`EMPTY_CHUNK`	400	パートの本文が空です。
`CHUNK_TOO_LARGE`	413	パートが 32 MB を超えています。
`CHUNK_TOO_SMALL`	400	最後以外のパートが 5 MB 未満です。
`NO_CHUNKS_UPLOADED`	400	パートが 1 つも送信される前に完了が呼び出されました。
`TOO_MANY_OPEN_UPLOADS`	429	アカウントに 32 件の未完了のアップロードがあります。いずれかを完了または中止してください。
`TOO_MANY_CONCURRENT_CHUNKS`	429	このアカウントではすでに 6 つのパートが送信中です。
`UPLOAD_NOT_FOUND`	404	アップロードは完了、中止、または期限切れになりました。

一時リンクと共有

コード	HTTP	意味
`INVALID_DOWNLOAD_EXPIRES`	400	`expires` が 60〜86400 秒の範囲外です。
`INVALID_FILENAME`	400	無効な文字を取り除いた後、`filename` が空になりました。
`INVALID_EXPIRES_IN`	400	`expires_in` が許可された範囲外です。
`INVALID_MAX_DOWNLOADS`	400	`max_downloads` が 1〜10000 の範囲外です。
`INVALID_PASSWORD`	400	パスワードは 8〜128 文字である必要があります。
`INVALID_SHARE`	400	共有 id の形式が正しくありません。
`SHARE_NOT_FOUND`	404	共有が存在しないか、すでに取り消されています。
`TOO_MANY_SHARES`	409	アカウントに 1000 件の有効な共有があります。先にいくつかを取り消してください。

アカウント設定とアップロードトークン

コード	HTTP	意味
`INVALID_BODY`	400	本文がないか、JSON オブジェクトではありません。
`INVALID_RULES`	400	`rules` が配列ではありません。
`TOO_MANY_RULES`	400	Enterprise でルールが 20 件を超えています。その他のプランでは、プランの上限 (Hobby と Standard で 5 件、Pro で 10 件) を超えると `UPGRADE_REQUIRED` が返されます。
`INVALID_RULE_PREFIX` / `DUPLICATE_RULE_PREFIX`	400	ルールのプレフィックスの形式が正しくないか、別のルールのプレフィックスと重複しています。
`INVALID_RULE_PRIVATE` / `INVALID_RULE_EXPIRE` / `INVALID_RULE_MAX_SIZE` / `INVALID_RULE_EXTENSIONS` / `INVALID_RULE_CACHE_CONTROL` / `INVALID_RULE_DELETE_AFTER`	400	ルールのフィールドが無効です。レスポンスにはそのルールの `prefix` が含まれます。
`INVALID_EXPIRES_IN` / `INVALID_MAX_USES` / `INVALID_MAX_SIZE` / `INVALID_ALLOWED_EXTENSIONS`	400	アップロードトークンのフィールドが範囲外です。
`UPLOAD_TOKEN_TOO_LARGE`	400	トークンのオプションがトークンに収まりません。メタデータまたは拡張子リストを短くしてください。

S3 認証情報

コード	HTTP	意味
`API_KEY_REQUIRED`	400	S3 認証情報は、ダッシュボードのセッションではなく API キーから導出されます。
`LEGACY_API_KEY`	400	API キーが旧形式です。アカウント設定で新しいキーを作成してください。
`INVALID_CREDENTIAL`	401	API キーを検証できませんでした。

S3 ゲートウェイは、代わりに標準の S3 XML エラーを返します。

グローバル

コード	HTTP	意味
`ROUTE_NOT_FOUND` / `NOT_FOUND`	404	ルートが存在しません。
`INTERNAL_SERVER_ERROR`	500	予期しないエラーです。しばらくしてから再試行してください。

はじめに

オブジェクト

チャンクアップロード

アカウント

共有リンク

S3

認証と制限

オブジェクト

アップロード

チャンクアップロード

一時リンクと共有

アカウント設定とアップロードトークン

S3 認証情報

グローバル

​認証と制限

​オブジェクト

​アップロード

​チャンクアップロード

​一時リンクと共有

​アカウント設定とアップロードトークン

​S3 認証情報

​グローバル

認証と制限

オブジェクト

アップロード

チャンクアップロード

一時リンクと共有

アカウント設定とアップロードトークン

S3 認証情報

グローバル