---
title: Instances
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[AI Search](https://developers.cloudflare.com/api/go/resources/ai_search)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Instances

##### [List AI Search instances.](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/list)

Deprecated

client.AISearch.Instances.List(ctx, params) (\*V4PagePaginationArray\[[InstanceListResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceListResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/ai-search/instances

##### [Create an AI Search instance (Search for Agents requires the default namespace).](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/create)

Deprecated

client.AISearch.Instances.New(ctx, params) (\*[InstanceNewResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/ai-search/instances

##### [Get an AI Search instance.](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/read)

Deprecated

client.AISearch.Instances.Read(ctx, id, query) (\*[InstanceReadResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceReadResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/ai-search/instances/{id}

##### [Update an AI Search instance (Search for Agents metadata requires the default namespace).](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/update)

Deprecated

client.AISearch.Instances.Update(ctx, id, params) (\*[InstanceUpdateResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceUpdateResponse%20%3E%20(schema)>), error)

PUT/accounts/{account\_id}/ai-search/instances/{id}

##### [Delete an AI Search instance.](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/delete)

Deprecated

client.AISearch.Instances.Delete(ctx, id, body) (\*[InstanceDeleteResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/ai-search/instances/{id}

##### [Get instance statistics.](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/stats)

Deprecated

client.AISearch.Instances.Stats(ctx, id, query) (\*[InstanceStatsResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceStatsResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/ai-search/instances/{id}/stats

##### [Search](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/search)

Deprecated

client.AISearch.Instances.Search(ctx, id, params) (\*[InstanceSearchResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceSearchResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/ai-search/instances/{id}/search

##### [Chat Completions](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/methods/chat_completions)

Deprecated

client.AISearch.Instances.ChatCompletions(ctx, id, params) (\*[InstanceChatCompletionsResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances%20%3E%20(model)%20InstanceChatCompletionsResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/ai-search/instances/{id}/chat/completions

#### InstancesJobs

##### [List Jobs](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/subresources/jobs/methods/list)

Deprecated

client.AISearch.Instances.Jobs.List(ctx, id, params) (\*V4PagePaginationArray\[[InstanceJobListResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances.jobs%20%3E%20(model)%20InstanceJobListResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/ai-search/instances/{id}/jobs

##### [Create new job](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/subresources/jobs/methods/create)

Deprecated

client.AISearch.Instances.Jobs.New(ctx, id, params) (\*[InstanceJobNewResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances.jobs%20%3E%20(model)%20InstanceJobNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/ai-search/instances/{id}/jobs

##### [Get a Job Details](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/subresources/jobs/methods/get)

Deprecated

client.AISearch.Instances.Jobs.Get(ctx, id, jobID, query) (\*[InstanceJobGetResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances.jobs%20%3E%20(model)%20InstanceJobGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/ai-search/instances/{id}/jobs/{job\_id}

##### [List Job Logs](https://developers.cloudflare.com/api/go/resources/ai_search/subresources/instances/subresources/jobs/methods/logs)

Deprecated

client.AISearch.Instances.Jobs.Logs(ctx, id, jobID, params) (\*\[] [InstanceJobLogsResponse](<https://developers.cloudflare.com/api/go/resources/ai_search#(resource)%20ai_search.instances.jobs%20%3E%20(model)%20InstanceJobLogsResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/ai-search/instances/{id}/jobs/{job\_id}/logs