---
title: Filter AI Search list items by exact object key
description: The list items endpoint now accepts a key query parameter to return the item matching an exact object key.
image: https://edgetunnel-b2h.pages.dev/changelog-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://edgetunnel-b2h.pages.dev/changelog/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# Changelog

New updates and improvements at Cloudflare.

[ Subscribe to RSS ](https://edgetunnel-b2h.pages.dev/changelog/rss/index.xml) [ View RSS feeds ](https://edgetunnel-b2h.pages.dev/fundamentals/new-features/available-rss-feeds/) 

![hero image](https://edgetunnel-b2h.pages.dev/_astro/hero.CVYJHPAd_26AMqX.svg) 

[ ← Back to all posts ](https://edgetunnel-b2h.pages.dev/changelog/) 

## Filter AI Search list items by exact object key

Jul 08, 2026 

[ AI Search ](https://edgetunnel-b2h.pages.dev/ai-search/) 

In [AI Search](https://edgetunnel-b2h.pages.dev/ai-search/), you can upload files to an instance, or connect a [data source](https://edgetunnel-b2h.pages.dev/ai-search/configuration/data-source/) such as an R2 bucket, to make your content searchable with natural language. Each file becomes an **item** identified by an object **key** (its filename or path). The [list items endpoint](https://edgetunnel-b2h.pages.dev/ai-search/api/items/rest-api/) returns the items in an instance.

That endpoint now accepts a `key` query parameter, so you can look up a single item by its exact object key without paging through the full list. This complements the existing `item_id` filter for when you know the key but not the ID.

```bash
curl "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/instances/<INSTANCE_NAME>/items?key=docs/readme.md" \
  -H "Authorization: Bearer <API_TOKEN>"
```

Keys are unique per data source, so combine `key` with `source` (for example, `source=builtin`) to disambiguate when the same key exists across multiple sources.

For more information, refer to [managing items](https://edgetunnel-b2h.pages.dev/ai-search/api/items/rest-api/).

```json
{"@context":"https://schema.org","@type":"BlogPosting","@id":"https://edgetunnel-b2h.pages.dev/changelog/post/2026-07-08-ai-search-list-items-key-filter/#page","headline":"Filter AI Search list items by exact object key · Changelog","description":"The list items endpoint now accepts a key query parameter to return the item matching an exact object key.","url":"https://edgetunnel-b2h.pages.dev/changelog/post/2026-07-08-ai-search-list-items-key-filter/","inLanguage":"en","image":"https://edgetunnel-b2h.pages.dev/changelog-preview.png","dateModified":"2026-07-08","datePublished":"2026-07-08","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://edgetunnel-b2h.pages.dev/#website","name":"Cloudflare Docs","url":"https://edgetunnel-b2h.pages.dev/"}}
```