Filter: apply

Namespace: microsoft.graph

Apply the given filter criteria on the given column.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Files.ReadWrite
Delegated (personal Microsoft account) Not supported.
Application Not supported.

HTTP request

POST /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/filter/apply
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/filter/apply
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/columns/{id|name}/filter/apply
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/columns/{id|name}/filter/apply

Request headers

Name Description
Authorization Bearer {token}. Required.

Request body

In the request body, provide a JSON object with the following parameters.

Parameter Type Description
criteria WorkbookFilterCriteria The criteria to apply.


If successful, this method returns 200 OK response code. It does not return anything in the response body.


Here is an example of how to call this API.


Here is an example of the request.

Content-type: application/json

  "criteria": {
    "criterion1": "criterion1-value",
    "criterion2": "criterion2-value",
    "color": "color-value",
    "operator": {
    "icon": {
      "set": "set-value",
      "index": 99
    "dynamicCriteria": "dynamicCriteria-value",
    "values": {
    "filterOn": "filterOn-value"

Here is an example of the response.

HTTP/1.1 200 OK