New

The executive guide to generative AI

Read more

Get filters API

edit

Retrieves filters.

Request

edit

GET _ml/filters/<filter_id>

GET _ml/filters/

Prerequisites

edit

Description

edit

You can get a single filter or all filters. For more information, see Machine learning custom rules.

Path parameters

edit
<filter_id>
(Optional, string) A string that uniquely identifies a filter.

Query parameters

edit
from
(Optional, integer) Skips the specified number of filters.
size
(Optional, integer) Specifies the maximum number of filters to obtain.

Response body

edit

The API returns an array of filter resources, which have the following properties:

description
(string) A description of the filter.
filter_id
(string) A string that uniquely identifies a filter.
items
(array of strings) An array of strings which is the filter item list.

Examples

edit
GET _ml/filters/safe_domains

The API returns the following results:

{
  "count": 1,
  "filters": [
    {
      "filter_id": "safe_domains",
      "description": "A list of safe domains",
      "items": [
        "*.google.com",
        "wikipedia.org"
      ]
    }
  ]
}
Was this helpful?
Feedback