# Find a file by attribute — OpenAI Storage

Botize method — `openai_storage.find_file` (action).

Search the 100 most recent files in an OpenAI Vector Store and return the first file whose attribute matches the given key and value.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `mb_switch` *(boolean)* — Rules
- `vector_store_id` *(string)* — Vector Store Id
- `attribute_key` *(string)* — Attribute key
- `attribute_value` *(string)* — Attribute value

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{match_found}}` *(boolean)* — Match found
- `{{matched_file_id}}` *(text)* — Matched file ID
- `{{matched_object}}` *(array)* — Matched file object (raw JSON from vector_store.file)
- `{{files_scanned}}` *(int)* — Number of files scanned

## Account

Needs a connected OpenAI Storage account in Botize: https://botize.com/en/app/openai_storage/authenticate

## This app

Every trigger and action for OpenAI Storage: https://botize.com/en/app/openai_storage.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/openai_storage/find_file