Interact with a Vectorize vector database using Wrangler.
vectorize create
Create a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize create <NAME>
yarn wrangler vectorize create <NAME>
pnpm wrangler vectorize create <NAME>
<NAME>stringrequired
The name of the Vectorize index to create (must be unique).
--dimensionsnumber
The dimension size to configure this index for, based on the output dimensions of your ML model.
--metricstring
The distance metric to use for searching within the index.
--presetstring
The name of an preset representing an embeddings model: Vectorize will configure the dimensions and distance metric for you when provided.
--descriptionstring
An optional description for this index.
--jsonbooleandefault: false
Return output as JSON
--deprecated-v1booleandefault: false
Create a deprecated Vectorize V1 index. This is not recommended and indexes created with this option need all other Vectorize operations to have this option enabled.
--use-remoteboolean
Use a remote binding when adding the newly created resource to your config
--update-configboolean
Automatically update your config file with the newly added resource
--bindingstring
The binding name of this resource in your Worker
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize delete
Delete a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize delete <NAME>
yarn wrangler vectorize delete <NAME>
pnpm wrangler vectorize delete <NAME>
<NAME>stringrequired
The name of the Vectorize index
--forcebooleanalias: --ydefault: false
Skip confirmation
--deprecated-v1booleandefault: false
Delete a deprecated Vectorize V1 index.
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize get
Get a Vectorize index by name
npm
yarn
pnpm
npx wrangler vectorize get <NAME>
yarn wrangler vectorize get <NAME>
pnpm wrangler vectorize get <NAME>
<NAME>stringrequired
The name of the Vectorize index.
--jsonbooleandefault: false
Return output as JSON
--deprecated-v1booleandefault: false
Fetch a deprecated V1 Vectorize index. This must be enabled if the index was created with V1 option.
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize list
List your Vectorize indexes
npm
yarn
pnpm
npx wrangler vectorize list
yarn wrangler vectorize list
pnpm wrangler vectorize list
--jsonbooleandefault: false
Return output as JSON
--deprecated-v1booleandefault: false
List deprecated Vectorize V1 indexes for your account.
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize list-vectors
List vector identifiers in a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize list-vectors <NAME>
yarn wrangler vectorize list-vectors <NAME>
pnpm wrangler vectorize list-vectors <NAME>
<NAME>stringrequired
The name of the Vectorize index
--countnumber
Maximum number of vectors to return (1-1000)
--cursorstring
Cursor for pagination to get the next page of results
--jsonbooleandefault: false
Return output as JSON
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize query
Query a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize query <NAME>
yarn wrangler vectorize query <NAME>
pnpm wrangler vectorize query <NAME>
<NAME>stringrequired
The name of the Vectorize index
--vectornumber
Vector to query the Vectorize Index
--vector-idstring
Identifier for a vector in the index against which the index should be queried
--top-knumberdefault: 5
The number of results (nearest neighbors) to return
--return-valuesbooleandefault: false
Specify if the vector values should be included in the results
--return-metadatastringdefault: none
Specify if the vector metadata should be included in the results
--namespacestring
Filter the query results based on this namespace
--filterstring
Filter the query results based on this metadata filter.
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize insert
Insert vectors into a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize insert <NAME>
yarn wrangler vectorize insert <NAME>
pnpm wrangler vectorize insert <NAME>
<NAME>stringrequired
The name of the Vectorize index.
--filestringrequired
A file containing line separated json (ndjson) vector objects.
--batch-sizenumberdefault: 1000
Number of vector records to include when sending to the Cloudflare API.
--jsonbooleandefault: false
return output as JSON
--deprecated-v1booleandefault: false
Insert into a deprecated V1 Vectorize index. This must be enabled if the index was created with the V1 option.
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize upsert
Upsert vectors into a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize upsert <NAME>
yarn wrangler vectorize upsert <NAME>
pnpm wrangler vectorize upsert <NAME>
<NAME>stringrequired
The name of the Vectorize index.
--filestringrequired
A file containing line separated json (ndjson) vector objects.
--batch-sizenumberdefault: 5000
Number of vector records to include in a single upsert batch when sending to the Cloudflare API.
--jsonbooleandefault: false
return output as JSON
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize get-vectors
Get vectors from a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize get-vectors <NAME>
yarn wrangler vectorize get-vectors <NAME>
pnpm wrangler vectorize get-vectors <NAME>
<NAME>stringrequired
The name of the Vectorize index.
--idsstringrequired
Vector identifiers to be fetched from the Vectorize Index. Example: --ids a 'b' 1 '2'
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize delete-vectors
Delete vectors in a Vectorize index
npm
yarn
pnpm
npx wrangler vectorize delete-vectors <NAME>
yarn wrangler vectorize delete-vectors <NAME>
pnpm wrangler vectorize delete-vectors <NAME>
<NAME>stringrequired
The name of the Vectorize index.
--idsstringrequired
Vector identifiers to be deleted from the Vectorize Index. Example: --ids a 'b' 1 '2'
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize info
Get additional details about the index
npm
yarn
pnpm
npx wrangler vectorize info <NAME>
yarn wrangler vectorize info <NAME>
pnpm wrangler vectorize info <NAME>
<NAME>stringrequired
The name of the Vectorize index.
--jsonbooleandefault: false
return output as JSON
--vbooleanalias: --version
Show version number
--cwdstring
Run as if Wrangler was started in the specified directory instead of the current working directory
--configstringalias: --c
Path to Wrangler configuration file
--envstringalias: --e
Environment to use for operations, and for selecting .env and .dev.vars files
--env-filestring
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
--install-skillsbooleandefault: false
Install Cloudflare skills for detected AI coding agents before running the command
--profilestring
Use a specific auth profile
vectorize create-metadata-index
Enable metadata filtering on the specified property