> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drime.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get File Tags

> Search or list file tags

## Overview

Returns tags that can be applied to file entries, optionally filtered by a search query. Useful for autocomplete functionality.

## Query Parameters

<ParamField query="query" type="string">
  Search query to filter tags
</ParamField>

## Response

<ResponseField name="tags" type="array">
  Array of tag objects

  <Expandable title="Tag properties">
    <ResponseField name="id" type="integer">
      Tag ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Tag name
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.drime.cloud/api/v1/file-entry-tags?query=project" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://app.drime.cloud/api/v1/file-entry-tags?query=project',
    {
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
      }
    }
  );

  const { tags } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.drime.cloud/api/v1/file-entry-tags',
      params={'query': 'project'},
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
  )

  tags = response.json()['tags']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "tags": [
      {
        "id": 1,
        "name": "project-alpha"
      },
      {
        "id": 2,
        "name": "project-beta"
      },
      {
        "id": 3,
        "name": "starred"
      }
    ]
  }
  ```
</ResponseExample>