Metadata filter

A metadata template to filter the search results by.

filters Metadata field filter (string) / Metadata field filter (float) / Metadata field filter (multi-select) / Metadata field filter (float range) / Metadata field filter (date range) object

example{"category":"online","contractValue":1000000}

Specifies which fields on the template to filter the search results by. When more than one field is specified, the query performs a logical AND to ensure that the instance of the template matches each of the fields specified.

scope string

example"enterprise"

Specifies the scope of the template to filter search results by.

This will be enterprise_{enterprise_id} for templates defined for use in this enterprise, and global for general templates that are available to all enterprises using Box.

Value is one of global,enterprise,enterprise_{enterprise_id}

templateKey string

example"contract"

The key of the template to filter search results by.

In many cases the template key is automatically derived of its display name, for example Contract Template would become contractTemplate. In some cases the creator of the template will have provided its own template key.

Please list the templates for an enterprise, or get all instances on a file or folder to inspect a template's key.

Response Example

{
  "filters": {
    "category": "online",
    "contractValue": 1000000
  },
  "scope": "enterprise",
  "templateKey": "contract"
}