Metadata filter (legacy)

Last updated Jun 17, 2026 This page documents the filter format used by the legacy AutoRAG REST API. For the new AI Search REST API filter syntax, refer to Metadata filtering.

Comparison filter

Compare a metadata attribute (for example, folder or timestamp) with a target value:

filters: {
  type: "eq",
  key: "folder",
  value: "customer-a/"
}

Operators

Operator Description
eq Equals
ne Not equals
gt Greater than
gte Greater than or equal to
lt Less than
lte Less than or equal to

Compound filter

Combine multiple comparison filters with a logical operator:

filters: {
  type: "and",
  filters: [
    { type: "eq", key: "folder", value: "customer-a/" },
    { type: "gte", key: "timestamp", value: "1735689600000" }
  ]
}

The available compound operators are and and or.

Limitations

  • No nested combinations of and and or. You can only use one compound operator at a time.
  • When using or, only the eq operator is allowed and all conditions must filter on the same key.

"Starts with" filter for folders

To filter for all files within a folder and its subfolders, use a compound filter with range operators.

For example, consider this file structure:

  • customer-a - profile.md - contracts - property - contract-1.pdf

Using { type: "eq", key: "folder", value: "customer-a/" } only matches files directly in that folder (like profile.md), not files in subfolders.

To match all files starting with customer-a/, use a compound filter:

filters: {
  type: "and",
  filters: [
    { type: "gt", key: "folder", value: "customer-a//" },
    { type: "lte", key: "folder", value: "customer-a/z" }
  ]
}

This filter matches all paths starting with customer-a/ by using:

  • gt with customer-a// to include paths greater than the / ASCII character
  • lte with customer-a/z to include paths up to and including the lowercase z ASCII character

Was this helpful?

YesNo

On this page

Metadata filter (legacy) - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/api/migration/autorag-filter-format/#page","headline":"Metadata filter (legacy)","description":"Reference for the legacy AutoRAG metadata filter format used with the previous REST API.","url":"https://developers.cloudflare.com/ai-search/api/migration/autorag-filter-format/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-search/api/migration/autorag-filter-format/og.png?v=91466c1e1606af89","dateModified":"2026-06-17","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/"}}

description: Migrate from the legacy AutoRAG REST API endpoints to the new AI Search API endpoints. title: REST API migration image: https://developers.cloudflare.com/ai-search/api/migration/rest-api/og.png?v=7b78382ff0fa7c57

Skip to 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.