---
description: Manage AI Search instances from the command line using Wrangler.
title: Wrangler CLI
image: https://developers.cloudflare.com/og-docs.png
---

[Skip to content](#main-content)

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/ai-search/llms.txt  
> Use this file to discover all available pages before exploring further.

# Wrangler CLI

Last updated Aug 24, 2026|Copy as Markdown|[View as Markdown](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/ai-search/wrangler-commands/index.md)|[Agent setup](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/agent-setup/)

## `ai-search list`

List all AI Search instances

npmyarnpnpm

```
npx wrangler ai-search list
```

```
yarn wrangler ai-search list
```

```
pnpm wrangler ai-search list
```

* `--namespace` `string` alias: --ndefault: default  
The namespace to list instances from.
* `--json` `boolean` default: false  
Return output as clean JSON
* `--page` `number` default: 1  
Page number of the results, can configure page size using "per-page"
* `--per-page` `number`  
Number of instances to show per page

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search create`

Create a new AI Search instance

npmyarnpnpm

```
npx wrangler ai-search create [NAME]
```

```
yarn wrangler ai-search create [NAME]
```

```
pnpm wrangler ai-search create [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance to create (must be unique within its namespace).
* `--namespace` `string` alias: --n  
The namespace to create the instance in.
* `--source` `string`  
Data source identifier (R2 bucket name or web URL).
* `--type` `string`  
The source type for the instance.
* `--parse-type` `string`  
How website URLs are discovered (--type web-crawler only). 'sitemap' reads XML sitemaps; 'discover' follows links recursively. Defaults to 'sitemap'.
* `--source-jurisdiction` `string`  
The R2 jurisdiction of the source bucket (e.g. eu, fedramp). Only valid with --type r2; omit for no specific jurisdiction.
* `--embedding-model` `string`  
Embedding model to use.
* `--generation-model` `string`  
LLM model for chat completions.
* `--chunk-size` `number`  
Chunk size for document splitting (min: 64).
* `--chunk-overlap` `number`  
Overlap between document chunks.
* `--max-num-results` `number`  
Maximum search results per query.
* `--reranking` `boolean`  
Enable reranking of search results.
* `--reranking-model` `string`  
Model to use for reranking.
* `--hybrid-search` `boolean`  
Enable hybrid (keyword + vector) search.
* `--cache` `boolean`  
Enable response caching.
* `--score-threshold` `number`  
Minimum relevance score threshold (0-1).
* `--prefix` `string`  
R2 key prefix to scope indexing.
* `--include-items` `array`  
Glob patterns for items to include.
* `--exclude-items` `array`  
Glob patterns for items to exclude.
* `--custom-metadata` `array`  
Custom metadata fields, formatted as 'field\_name:data\_type'. data\_type must be one of: text, number, boolean, datetime. Repeat the flag for multiple fields (e.g. --custom-metadata title:text --custom-metadata views:number).
* `--custom-metadata-schema` `string`  
Path to a JSON file describing custom metadata fields. The file must contain an array of { "field\_name", "data\_type" } objects. Mutually exclusive with --custom-metadata.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search get`

Get details of an AI Search instance

npmyarnpnpm

```
npx wrangler ai-search get [NAME]
```

```
yarn wrangler ai-search get [NAME]
```

```
pnpm wrangler ai-search get [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search update`

Update an AI Search instance configuration

npmyarnpnpm

```
npx wrangler ai-search update [NAME]
```

```
yarn wrangler ai-search update [NAME]
```

```
pnpm wrangler ai-search update [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance to update.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--embedding-model` `string`  
Update the embedding model.
* `--generation-model` `string`  
Update the LLM model for chat completions.
* `--chunk-size` `number`  
Update the chunk size.
* `--chunk-overlap` `number`  
Update the chunk overlap.
* `--max-num-results` `number`  
Update max search results per query.
* `--reranking` `boolean`  
Enable or disable reranking.
* `--reranking-model` `string`  
Update the reranking model.
* `--hybrid-search` `boolean`  
Enable or disable hybrid search.
* `--cache` `boolean`  
Enable or disable caching.
* `--score-threshold` `number`  
Update the minimum relevance score threshold (0-1).
* `--paused` `boolean`  
Pause or resume the instance.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search delete`

Delete an AI Search instance

npmyarnpnpm

```
npx wrangler ai-search delete [NAME]
```

```
yarn wrangler ai-search delete [NAME]
```

```
pnpm wrangler ai-search delete [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance to delete.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--force` `boolean` alias: --ydefault: false  
Skip confirmation

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search stats`

Get usage statistics for an AI Search instance

npmyarnpnpm

```
npx wrangler ai-search stats [NAME]
```

```
yarn wrangler ai-search stats [NAME]
```

```
pnpm wrangler ai-search stats [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search search`

Execute a semantic search query against an AI Search instance

npmyarnpnpm

```
npx wrangler ai-search search [NAME]
```

```
yarn wrangler ai-search search [NAME]
```

```
pnpm wrangler ai-search search [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--query` `string` required  
The search query text.
* `--max-num-results` `number`  
Override maximum number of results.
* `--score-threshold` `number`  
Override minimum relevance score (0-1).
* `--reranking` `boolean`  
Override reranking setting.
* `--filter` `array`  
Metadata filter as key=value (repeatable, e.g. --filter type=docs --filter lang=en).
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search namespace list`

List all AI Search namespaces

npmyarnpnpm

```
npx wrangler ai-search namespace list
```

```
yarn wrangler ai-search namespace list
```

```
pnpm wrangler ai-search namespace list
```

* `--json` `boolean` default: false  
Return output as clean JSON
* `--page` `number` default: 1  
Page number of the results, can configure page size using "per-page"
* `--per-page` `number`  
Number of namespaces to show per page
* `--search` `string`  
Filter namespaces whose name or description contains this string (case-insensitive).

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search namespace create`

Create a new AI Search namespace

npmyarnpnpm

```
npx wrangler ai-search namespace create [NAME]
```

```
yarn wrangler ai-search namespace create [NAME]
```

```
pnpm wrangler ai-search namespace create [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search namespace to create.
* `--description` `string`  
Optional description for the namespace (max 256 chars).
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search namespace get`

Get details of an AI Search namespace

npmyarnpnpm

```
npx wrangler ai-search namespace get [NAME]
```

```
yarn wrangler ai-search namespace get [NAME]
```

```
pnpm wrangler ai-search namespace get [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search namespace.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search namespace update`

Update an AI Search namespace

npmyarnpnpm

```
npx wrangler ai-search namespace update [NAME]
```

```
yarn wrangler ai-search namespace update [NAME]
```

```
pnpm wrangler ai-search namespace update [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search namespace to update.
* `--description` `string`  
Updated description for the namespace (max 256 chars).
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search namespace delete`

Delete an AI Search namespace

npmyarnpnpm

```
npx wrangler ai-search namespace delete [NAME]
```

```
yarn wrangler ai-search namespace delete [NAME]
```

```
pnpm wrangler ai-search namespace delete [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search namespace to delete.
* `--force` `boolean` alias: --ydefault: false  
Skip confirmation

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search jobs list`

List indexing jobs for an AI Search instance

npmyarnpnpm

```
npx wrangler ai-search jobs list [NAME]
```

```
yarn wrangler ai-search jobs list [NAME]
```

```
pnpm wrangler ai-search jobs list [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--json` `boolean` default: false  
Return output as clean JSON
* `--page` `number` default: 1  
Page number of the results, can configure page size using "per-page"
* `--per-page` `number`  
Number of jobs to show per page

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search jobs create`

Trigger a new indexing job for an AI Search instance

npmyarnpnpm

```
npx wrangler ai-search jobs create [NAME]
```

```
yarn wrangler ai-search jobs create [NAME]
```

```
pnpm wrangler ai-search jobs create [NAME]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--description` `string`  
Optional description for the indexing job.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search jobs get`

Get details of an AI Search indexing job

npmyarnpnpm

```
npx wrangler ai-search jobs get [NAME] [JOB-ID]
```

```
yarn wrangler ai-search jobs get [NAME] [JOB-ID]
```

```
pnpm wrangler ai-search jobs get [NAME] [JOB-ID]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `[JOB-ID]` `string` required  
The ID of the indexing job.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--json` `boolean` default: false  
Return output as clean JSON

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search jobs cancel`

Cancel an in-progress AI Search indexing job

npmyarnpnpm

```
npx wrangler ai-search jobs cancel [NAME] [JOB-ID]
```

```
yarn wrangler ai-search jobs cancel [NAME] [JOB-ID]
```

```
pnpm wrangler ai-search jobs cancel [NAME] [JOB-ID]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `[JOB-ID]` `string` required  
The ID of the indexing job to cancel.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--force` `boolean` alias: --ydefault: false  
Skip confirmation

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

## `ai-search jobs logs`

List log entries for an AI Search indexing job

npmyarnpnpm

```
npx wrangler ai-search jobs logs [NAME] [JOB-ID]
```

```
yarn wrangler ai-search jobs logs [NAME] [JOB-ID]
```

```
pnpm wrangler ai-search jobs logs [NAME] [JOB-ID]
```

* `[NAME]` `string` required  
The name of the AI Search instance.
* `[JOB-ID]` `string` required  
The ID of the indexing job.
* `--namespace` `string` alias: --ndefault: default  
The namespace the instance belongs to.
* `--json` `boolean` default: false  
Return output as clean JSON
* `--page` `number` default: 1  
Page number of the results, can configure page size using "per-page"
* `--per-page` `number`  
Number of log entries to show per page

Global flags

* `--v` `boolean` alias: --version  
Show version number
* `--cwd` `string`  
Run as if Wrangler was started in the specified directory instead of the current working directory
* `--config` `string` alias: --c  
Path to Wrangler configuration file
* `--env` `string` alias: --e  
Environment to use for operations, and for selecting .env and .dev.vars files
* `--env-file` `string`  
Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files
* `--experimental-provision` `boolean` aliases: --x-provisiondefault: true  
Experimental: Enable automatic resource provisioning
* `--experimental-auto-create` `boolean` alias: --x-auto-createdefault: true  
Automatically provision draft bindings with new resources
* `--install-skills` `boolean` default: false  
Install Cloudflare skills for detected AI coding agents before running the command
* `--profile` `string`  
Use a specific auth profile

Was this helpful?

YesNo

## On this page

[![](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/)

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/wrangler-commands/#page","headline":"Wrangler CLI · Cloudflare AI Search docs","description":"Manage AI Search instances from the command line using Wrangler.","url":"https://developers.cloudflare.com/ai-search/wrangler-commands/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-24","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```