# Blob diagnostics

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

Each Blob error has a stable `code`. Its `docs` link opens the page of that code. This page lists all 99 codes, and [All diagnostics](https://vitehub.dev/docs/reference/diagnostics) lists every primitive.

## Published numbered errors

| Code | What happened |
| --- | --- |
| [`BLOB_B0001`](https://vitehub.dev/docs/blob/diagnostics/blob_b0001) | \<authorizeModule\> exports `authorize`, but `blob.serve.authorize` is not true. Set `blob.serve.authorize: true` so the serve route uses it. |
| [`BLOB_B0002`](https://vitehub.dev/docs/blob/diagnostics/blob_b0002) | `blob.serve.authorize` requires an Auth Definition. Enable Auth and add `server/auth.ts`. |
| [`BLOB_B0003`](https://vitehub.dev/docs/blob/diagnostics/blob_b0003) | Only one Blob serve module is allowed. Found: \<value\> |
| [`BLOB_B0004`](https://vitehub.dev/docs/blob/diagnostics/blob_b0004) | \<value\> Install it in your app with: pnpm add \<install\> |
| [`BLOB_B0005`](https://vitehub.dev/docs/blob/diagnostics/blob_b0005) | `blob.images.transformer` is "sharp", but the project cannot resolve sharp. Install it with: pnpm add sharp |
| [`BLOB_B0006`](https://vitehub.dev/docs/blob/diagnostics/blob_b0006) | `blob.serve.anonymous` requires an `authorize` export in `server/blob.ts` to decide signed-out requests. |
| [`BLOB_B0007`](https://vitehub.dev/docs/blob/diagnostics/blob_b0007) | `blob.images.transformer` is "photon", but the project cannot resolve @cf-wasm/photon. Install it with: pnpm add @cf-wasm/photon |
| [`BLOB_C0001`](https://vitehub.dev/docs/blob/diagnostics/blob_c0001) | `blob.driver` is \<driver\>. ViteHub renamed this driver to "\<renamed\>", and it does not read \<driver\>. |
| [`BLOB_C0002`](https://vitehub.dev/docs/blob/diagnostics/blob_c0002) | `blob.serve.headers` must be a plain object. |
| [`BLOB_C0003`](https://vitehub.dev/docs/blob/diagnostics/blob_c0003) | `blob.serve.headers` values must be strings. |
| [`BLOB_C0004`](https://vitehub.dev/docs/blob/diagnostics/blob_c0004) | `blob.serve.headers` contains an invalid HTTP header: \<name\>. |
| [`BLOB_C0005`](https://vitehub.dev/docs/blob/diagnostics/blob_c0005) | `blob.serve` must be a plain object that says who may read the files. Received \<value\>. |
| [`BLOB_C0006`](https://vitehub.dev/docs/blob/diagnostics/blob_c0006) | `blob.serve.store` must reference a configured Blob store: \<store\>. |
| [`BLOB_C0007`](https://vitehub.dev/docs/blob/diagnostics/blob_c0007) | `blob` must be a plain object. |
| [`BLOB_C0008`](https://vitehub.dev/docs/blob/diagnostics/blob_c0008) | `blob.stores.default` is required when using named Blob stores. |
| [`BLOB_C0009`](https://vitehub.dev/docs/blob/diagnostics/blob_c0009) | Missing runtime environment variable `BLOB_READ_WRITE_TOKEN` for the configured Vercel Blob token. |
| [`BLOB_C0010`](https://vitehub.dev/docs/blob/diagnostics/blob_c0010) | Missing runtime environment variable `MINIO_ACCESS_KEY_ID`, `MINIO_ACCESS_KEY`, `MINIO_ROOT_USER`, or `AWS_ACCESS_KEY_ID` for MinIO Blob. |
| [`BLOB_C0011`](https://vitehub.dev/docs/blob/diagnostics/blob_c0011) | Missing runtime environment variable `MINIO_SECRET_ACCESS_KEY`, `MINIO_SECRET_KEY`, `MINIO_ROOT_PASSWORD`, or `AWS_SECRET_ACCESS_KEY` for MinIO Blob. |
| [`BLOB_C0012`](https://vitehub.dev/docs/blob/diagnostics/blob_c0012) | `blob.serve.authorize` must be a boolean. Export an `authorize` function from `server/blob.ts` for per-request rules. |
| [`BLOB_C0013`](https://vitehub.dev/docs/blob/diagnostics/blob_c0013) | `blob.stores` must be a plain object. |
| [`BLOB_C0014`](https://vitehub.dev/docs/blob/diagnostics/blob_c0014) | Cloudflare R2 `jurisdiction` must be "eu", "fedramp", or "us". Received \<source\>. |
| [`BLOB_C0015`](https://vitehub.dev/docs/blob/diagnostics/blob_c0015) | See the page of the code. |
| [`BLOB_C0016`](https://vitehub.dev/docs/blob/diagnostics/blob_c0016) | `blob.serve.anonymous` must be a boolean. |
| [`BLOB_C0017`](https://vitehub.dev/docs/blob/diagnostics/blob_c0017) | `<path>` must be true or false. Received \<value\>. |
| [`BLOB_C0018`](https://vitehub.dev/docs/blob/diagnostics/blob_c0018) | `<path>` is true, but the store uses the local `fs` driver. Set a hosted `driver`, or remove `remote`. |
| [`BLOB_C0019`](https://vitehub.dev/docs/blob/diagnostics/blob_c0019) | \<reason\>: no variable in `process.env` holds its value when the Vite config loads. ViteHub does not write credentials into the build output. Read it from an env variable\<value\>. |
| [`BLOB_C0020`](https://vitehub.dev/docs/blob/diagnostics/blob_c0020) | \<reason\>, and \<value\> hold its value at build time. ViteHub cannot tell which variable the config reads. |
| [`BLOB_C0021`](https://vitehub.dev/docs/blob/diagnostics/blob_c0021) | `blob.serve.public` is not an option. Set `access: "public"` to serve the files to anyone. |
| [`BLOB_C0022`](https://vitehub.dev/docs/blob/diagnostics/blob_c0022) | `<path>.access` is "public", but `blob.serve` requires `authorize: true` for this store. Anyone could read its objects from their public Vercel Blob URLs. |
| [`BLOB_C0023`](https://vitehub.dev/docs/blob/diagnostics/blob_c0023) | `<path>.<option>` is not an option of the s3 driver. Set `<path>.credentials.<option>` instead. |
| [`BLOB_R0001`](https://vitehub.dev/docs/blob/diagnostics/blob_r0001) | R2 binding "\<binding\>" not found |
| [`BLOB_R0002`](https://vitehub.dev/docs/blob/diagnostics/blob_r0002) | Cloudflare R2 signed requests require `accountId`, `accessKeyId`, `secretAccessKey`, and `bucketName` HTTP credentials. |
| [`BLOB_R0003`](https://vitehub.dev/docs/blob/diagnostics/blob_r0003) | Missing runtime environment variable `BLOB_BUCKET_NAME`, `CLOUDFLARE_R2_BUCKET_NAME`, or `R2_BUCKET_NAME` for Cloudflare R2 Blob. |
| [`BLOB_R0004`](https://vitehub.dev/docs/blob/diagnostics/blob_r0004) | Cloudflare R2 signed requests require `accountId`, `accessKeyId`, `secretAccessKey`, and `bucketName` HTTP credentials. |
| [`BLOB_R0005`](https://vitehub.dev/docs/blob/diagnostics/blob_r0005) | Blob pathname escapes the configured base: \<pathname\> |
| [`BLOB_R0006`](https://vitehub.dev/docs/blob/diagnostics/blob_r0006) | The environment has not been configured to use Netlify Blobs. Supply siteID and token when creating the store. |
| [`BLOB_R0007`](https://vitehub.dev/docs/blob/diagnostics/blob_r0007) | Netlify Blobs strong consistency requires an uncached edge URL. |
| [`BLOB_R0008`](https://vitehub.dev/docs/blob/diagnostics/blob_r0008) | The environment has not been configured with a Netlify deploy ID. |
| [`BLOB_R0009`](https://vitehub.dev/docs/blob/diagnostics/blob_r0009) | Netlify Blobs deploy stores require a primary region when using the edge endpoint. |
| [`BLOB_R0010`](https://vitehub.dev/docs/blob/diagnostics/blob_r0010) | Netlify Blobs list failed with status \<status\>. |
| [`BLOB_R0011`](https://vitehub.dev/docs/blob/diagnostics/blob_r0011) | The Vercel Blob driver does not support custom metadata |
| [`BLOB_R0012`](https://vitehub.dev/docs/blob/diagnostics/blob_r0012) | The "\<driver\>" blob driver requires \<installId\>. Install it with: pnpm add \<installId\> |
| [`BLOB_R0013`](https://vitehub.dev/docs/blob/diagnostics/blob_r0013) | Aborted |
| [`BLOB_R0014`](https://vitehub.dev/docs/blob/diagnostics/blob_r0014) | Aborted |
| [`BLOB_R0015`](https://vitehub.dev/docs/blob/diagnostics/blob_r0015) | Expected the first argument to be a `function`, got `<value>`. |
| [`BLOB_R0017`](https://vitehub.dev/docs/blob/diagnostics/blob_r0017) | Blob provider listing returned a repeated pagination cursor. |
| [`BLOB_R0018`](https://vitehub.dev/docs/blob/diagnostics/blob_r0018) | Cloudflare R2 provisioning returned an invalid bucket list. |
| [`BLOB_R0019`](https://vitehub.dev/docs/blob/diagnostics/blob_r0019) | Vercel Blob provisioning did not return store metadata. |
| [`BLOB_R0020`](https://vitehub.dev/docs/blob/diagnostics/blob_r0020) | Vercel Blob is connected to the project without all required environments. |
| [`BLOB_R0021`](https://vitehub.dev/docs/blob/diagnostics/blob_r0021) | Vercel Blob is connected to the project without all required environments. |
| [`BLOB_R0022`](https://vitehub.dev/docs/blob/diagnostics/blob_r0022) | Vercel Blob provisioning did not return a store id. |
| [`BLOB_R0023`](https://vitehub.dev/docs/blob/diagnostics/blob_r0023) | Blob runtime is disabled. |
| [`BLOB_R0024`](https://vitehub.dev/docs/blob/diagnostics/blob_r0024) | `expiresIn` must be a positive integer. |
| [`BLOB_R0025`](https://vitehub.dev/docs/blob/diagnostics/blob_r0025) | Cloudflare R2 cannot bind `maxSize` to a signed request. |
| [`BLOB_R0026`](https://vitehub.dev/docs/blob/diagnostics/blob_r0026) | Named Blob stores are only available from the @vite-hub/blob runtime export. |
| [`BLOB_R0027`](https://vitehub.dev/docs/blob/diagnostics/blob_r0027) | See the page of the code. |
| [`BLOB_R0028`](https://vitehub.dev/docs/blob/diagnostics/blob_r0028) | See the page of the code. |
| [`BLOB_R0029`](https://vitehub.dev/docs/blob/diagnostics/blob_r0029) | --store needs a nonempty name. |
| [`BLOB_R0030`](https://vitehub.dev/docs/blob/diagnostics/blob_r0030) | Cloudflare R2 multipart uploads require the "\<binding\>" R2 binding. |
| [`BLOB_R0031`](https://vitehub.dev/docs/blob/diagnostics/blob_r0031) | `partNumber` must be an integer from 1 to \<maxPartNumber\>. |
| [`BLOB_R0032`](https://vitehub.dev/docs/blob/diagnostics/blob_r0032) | Unknown multipart upload: \<uploadId\> |
| [`BLOB_R0033`](https://vitehub.dev/docs/blob/diagnostics/blob_r0033) | Cloudflare R2 returned an invalid list page: `truncated` must be a boolean, and `cursor` is present only when `truncated` is true. |
| [`BLOB_R0034`](https://vitehub.dev/docs/blob/diagnostics/blob_r0034) | Invalid blob \<value\> \<pathname\>: it \<issue\>. |
| [`BLOB_R0035`](https://vitehub.dev/docs/blob/diagnostics/blob_r0035) | See the page of the code. |
| [`BLOB_R0036`](https://vitehub.dev/docs/blob/diagnostics/blob_r0036) | The photon image transformer \<message\> |
| [`BLOB_R0037`](https://vitehub.dev/docs/blob/diagnostics/blob_r0037) | A read-only Blob handle signs GET requests only. Use blob.store(name) for a PUT request. |
| [`BLOB_R0038`](https://vitehub.dev/docs/blob/diagnostics/blob_r0038) | Blob store mode must be "read" or "write", not \<mode\>. |
| [`BLOB_R0039`](https://vitehub.dev/docs/blob/diagnostics/blob_r0039) | `maxSize` must be a size such as "8MB". Received \<maxSize\>. |
| [`BLOB_R0040`](https://vitehub.dev/docs/blob/diagnostics/blob_r0040) | See the page of the code. |
| [`BLOB_R0041`](https://vitehub.dev/docs/blob/diagnostics/blob_r0041) | A signed Blob link accepts GET or PUT, not \<method\>. |
| [`BLOB_R0042`](https://vitehub.dev/docs/blob/diagnostics/blob_r0042) | The signed Blob link expired at \<value\>. |
| [`BLOB_R0043`](https://vitehub.dev/docs/blob/diagnostics/blob_r0043) | The body is larger than the \<maxSize\> bytes that the signed Blob link accepts. |
| [`BLOB_R0044`](https://vitehub.dev/docs/blob/diagnostics/blob_r0044) | Missing runtime environment variable `<name>` for the `<option>` option of the \<driver\> Blob store. |
| [`BLOB_R0045`](https://vitehub.dev/docs/blob/diagnostics/blob_r0045) | `access` is not a Blob put() option. One object cannot be private on its own: the store and `blob.serve` decide who may read it. |
| [`BLOB_R0046`](https://vitehub.dev/docs/blob/diagnostics/blob_r0046) | A direct upload cannot set `put.access`, `put.contentLength`, or `put.customMetadata`. |
| [`BLOB_R0047`](https://vitehub.dev/docs/blob/diagnostics/blob_r0047) | `edgeCache.maxAge` must be a positive integer. |

## Errors

| Code | What happened |
| --- | --- |
| [`BLOB_CONFLICT`](https://vitehub.dev/docs/blob/diagnostics/blob_conflict) | The Blob \<operation\> operation conflicts with existing objects in the "\<store\>" store. |
| [`BLOB_IMAGE_VARIANT_INVALID`](https://vitehub.dev/docs/blob/diagnostics/blob_image_variant_invalid) | Image variant `<parameter>` must be \<expected\>. |
| [`BLOB_INVALID_CURSOR`](https://vitehub.dev/docs/blob/diagnostics/blob_invalid_cursor) | The Blob list cursor is not valid. It is not a cursor that a `list()` result of this store returned. |
| [`BLOB_NOT_FOUND`](https://vitehub.dev/docs/blob/diagnostics/blob_not_found) | The Blob \<operation\> operation found no object in the "\<store\>" store. |
| [`BLOB_OPERATION_FAILED`](https://vitehub.dev/docs/blob/diagnostics/blob_operation_failed) | The Blob \<operation\> operation failed on the "\<store\>" store. |
| [`BLOB_PATHNAME_TOO_LONG`](https://vitehub.dev/docs/blob/diagnostics/blob_pathname_too_long) | The pathname is \<bytes\> bytes in UTF-8. Cloudflare R2 accepts object keys of at most \<limit\> bytes. |
| [`BLOB_REFERENCE_OPTION_INVALID`](https://vitehub.dev/docs/blob/diagnostics/blob_reference_option_invalid) | \<kind\>() accept entry "\<value\>" is not a MIME type or pattern such as "image/png" or "image/*". |
| [`BLOB_REFERENCE_SCHEMA_TARGET_UNSUPPORTED`](https://vitehub.dev/docs/blob/diagnostics/blob_reference_schema_target_unsupported) | Blob reference schemas emit draft-07, draft-2020-12, or openapi-3.0 JSON Schema, not "\<target\>". |
| [`BLOB_RESPONSIVE_IMAGE_URL_MISSING`](https://vitehub.dev/docs/blob/diagnostics/blob_responsive_image_url_missing) | responsiveImage() needs the served URL of the image. Read the record from the served Blob Store or pass `url`. |
| [`BLOB_UPLOAD_OPTION_INVALID`](https://vitehub.dev/docs/blob/diagnostics/blob_upload_option_invalid) | partSize must be a finite positive number. |
| [`BLOB_UPLOAD_REQUEST_FAILED`](https://vitehub.dev/docs/blob/diagnostics/blob_upload_request_failed) | Upload request failed with status \<status\>\<value\> |
| [`BLOB_UPLOAD_RESPONSE_INVALID`](https://vitehub.dev/docs/blob/diagnostics/blob_upload_response_invalid) | Upload request returned a part number that does not match the requested part. |

## Operation errors

| Code | What happened |
| --- | --- |
| [`BLOB_DISABLED`](https://vitehub.dev/docs/blob/diagnostics/blob_disabled) | Blob is disabled in this runtime. |
| [`BLOB_DOWNLOAD_TOO_LARGE`](https://vitehub.dev/docs/blob/diagnostics/blob_download_too_large) | Blob \<pathname\> is \<size\> bytes. The blob operations return at most \<limit\> bytes. |
| [`BLOB_EXISTS`](https://vitehub.dev/docs/blob/diagnostics/blob_exists) | Blob \<pathname\> already exists in store \<store\>. |
| [`BLOB_FS_WRITE_STALLED`](https://vitehub.dev/docs/blob/diagnostics/blob_fs_write_stalled) | Multipart output write made no progress. |
| [`BLOB_INVALID_INPUT`](https://vitehub.dev/docs/blob/diagnostics/blob_invalid_input) | The \<operation\> operation requires a pathname. |
| [`BLOB_OBJECT_CHANGED_DURING_READ`](https://vitehub.dev/docs/blob/diagnostics/blob_object_changed_during_read) | Blob changed while reading its filesystem \<step\>. |
| [`BLOB_PUT_CONDITION_UNSUPPORTED`](https://vitehub.dev/docs/blob/diagnostics/blob_put_condition_unsupported) | Blob driver "\<driver\>" cannot check a `put()` condition in the provider, so it cannot write only if the object is unchanged or new. |
| [`BLOB_RESERVED_PATH`](https://vitehub.dev/docs/blob/diagnostics/blob_reserved_path) | The \<operation\> operation cannot change \<pathname\>. ViteHub owns the paths under `_vitehub/`. |
| [`BLOB_STORE_NOT_FOUND`](https://vitehub.dev/docs/blob/diagnostics/blob_store_not_found) | Blob store "\<name\>" was not found. Stores: \<stores\>. |
| [`BLOB_UPLOAD_TOO_LARGE`](https://vitehub.dev/docs/blob/diagnostics/blob_upload_too_large) | The file is \<size\> bytes. The blob operations accept at most \<limit\> bytes. |

## Option errors

| Code | What happened |
| --- | --- |
| [`BLOB_UPLOAD_MAX_FILES_INVALID`](https://vitehub.dev/docs/blob/diagnostics/blob_upload_max_files_invalid) | `maxFiles` of `handleUpload()` is \<maxFiles\>. It must be a positive integer. |

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/blob.md)
- [Get started](https://vitehub.dev/raw/docs/blob/get-started.md)
- [Configure](https://vitehub.dev/raw/docs/blob/configure.md)
- [Server API](https://vitehub.dev/raw/docs/blob/server-api.md)
- [Agent capability](https://vitehub.dev/raw/docs/blob/agent-capability.md)
- [Hosts](https://vitehub.dev/raw/docs/blob/hosts.md)
- [Limits and errors](https://vitehub.dev/raw/docs/blob/limits-and-errors.md)
- [Media and images](https://vitehub.dev/raw/docs/blob/media.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
