> ## AI Agent Context
> Get the complete documentation index at: https://aistudio.google.com/llms.txt
> Use this file to discover all available pages.
> For the full documentation in a single file, fetch: https://aistudio.google.com/llms-full.txt

# File Search Stores

The File Search API provides a hosted question answering service for building Retrieval Augmented Generation (RAG) systems using Google's infrastructure.

## Methods  {% id="methods" %}

{% table %}
  * Method
  * HTTP request

  ---

  * [Creating a file search store](/api-reference/file-search/file-search-stores/create-file-search-store)
  *     {% mark class="http-post" %}{% icon name="north_east" /%}`POST`{% /mark %} `/v1beta/fileSearchStores`

    Creates an empty [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore).


  ---

  * [Deleting a file search store](/api-reference/file-search/file-search-stores/delete-file-search-store)
  *     {% mark class="http-delete" %}{% icon name="close" /%}`DELETE`{% /mark %} `/v1beta/fileSearchStores/{fileSearchStore}`

    Deletes a [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore).


  ---

  * [Getting a file search store](/api-reference/file-search/file-search-stores/get-file-search-store)
  *     {% mark class="http-get" %}{% icon name="south_west" /%}`GET`{% /mark %} `/v1beta/fileSearchStores/{fileSearchStore}`

    Gets information about a specific [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore).


  ---

  * [Listing file search stores](/api-reference/file-search/file-search-stores/list-file-search-stores)
  *     {% mark class="http-get" %}{% icon name="south_west" /%}`GET`{% /mark %} `/v1beta/fileSearchStores`

    Lists all `FileSearchStores` owned by the user.


  ---

  * [Importing a file](/api-reference/file-search/file-search-stores/import-file)
  *     {% mark class="http-post" %}{% icon name="north_east" /%}`POST`{% /mark %} `/v1beta/fileSearchStores/{fileSearchStore}:importFile`

    Imports a `File` from File Service to a [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore).


  ---

  * [Getting an operation](/api-reference/file-search/file-search-stores/get-file-search-store-operation)
  *     {% mark class="http-get" %}{% icon name="south_west" /%}`GET`{% /mark %} `/v1beta/fileSearchStores/{fileSearchStore}/operations/{operation}`

    Gets the latest state of a long-running operation.


  ---

  * [Getting an upload operation](/api-reference/file-search/file-search-stores/get-file-search-store-upload-operation)
  *     {% mark class="http-get" %}{% icon name="south_west" /%}`GET`{% /mark %} `/v1beta/fileSearchStores/{fileSearchStoresId}/upload/operations/{operationsId}`

    Gets the latest state of a long-running operation.


  ---

  * [Uploading to a file search store](/api-reference/file-search/file-search-stores/upload-to-file-search-store)
  *     {% mark class="http-post" %}{% icon name="north_east" /%}`POST`{% /mark %} `/v1beta/fileSearchStores/{fileSearchStore}:uploadToFileSearchStore`

    Uploads data to a FileSearchStore, preprocesses and chunks before storing it in a FileSearchStore Document.

{% /table %}

## Resources  {% id="resources" %}

### FileSearchStore  {% id="Resource:FileSearchStore" %}

A [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) is a collection of `Document`s.

**Properties:**

{% section class="api-ref-property-list" %}
  **name**: `string`

  Output only. Immutable. Identifier. The [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) resource name. It is an ID (name excluding the "fileSearchStores/" prefix) that can contain up to 40 characters that are lowercase alphanumeric or dashes (-). It is output only. The unique name will be derived from `display_name` along with a 12 character random suffix. Example: `fileSearchStores/my-awesome-file-search-store-123a456b789c` If `display_name` is not provided, the name will be randomly generated.

  {% hr /%}

  **displayName**: `string`

  Optional. The human-readable display name for the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore). The display name must be no more than 512 characters in length, including spaces. Example: "Docs on Semantic Retriever"

  {% hr /%}

  **createTime**: `string`

  Output only. The Timestamp of when the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) was created.

  {% hr /%}

  **updateTime**: `string`

  Output only. The Timestamp of when the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) was last updated.

  {% hr /%}

  **activeDocumentsCount**: `string`

  Output only. The number of documents in the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) that are active and ready for retrieval.

  {% hr /%}

  **pendingDocumentsCount**: `string`

  Output only. The number of documents in the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) that are being processed.

  {% hr /%}

  **failedDocumentsCount**: `string`

  Output only. The number of documents in the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore) that have failed processing.

  {% hr /%}

  **sizeBytes**: `string`

  Output only. The size of raw bytes ingested into the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore). This is the total size of all the documents in the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore).

  {% hr /%}

  **embeddingModel**: `string`

  Optional. The embedding model to use for the [`FileSearchStore`](/api-reference/file-search/file-search-stores#Resource:FileSearchStore). The model's resource name. This serves as an ID for the Model to use. Format: `models/{model}`. If not specified, the default embedding model will be used.

{% /section %}

