Content Filter Rules

Get Content Filter Rules

Get all Content Filter Rules in a configuration

GET/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Response

200422

Content Filter Rules retrieved successfully

Body

application/json

totalinteger

Example: 1

itemsarray of ContentFilterRule

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "total": 1,
  "items": [
    {
      "category": "text",
      "description": "text",
      "id": "text",
      "msg": "text",
      "name": "text",
      "operand": "text",
      "risk": 0,
      "subcategory": "text",
      "tags": [
        "text"
      ]
    }
  ]
}

Modify Content Filter Rules

Update an existing set of Content Filter Rules for a configuration

PUT/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Body

application/json

category*Category

Category of the rule

descriptionDescription

stringnull

id*Id

msg*Message

Log message for this rule

name*Name

operand*Operand

Matching domain(s) regex

risk*Risk Level

Risk level of this rule, between 1 (lowest risk) and 5 (highest risk)

subcategory*Subcategory

Subcategory of the rule

tagsTags List

List of tags to apply

Response

200422

Content Filter Rules updated successfully

Body

application/json

message*Message

Information about successful update operation

Example: "Successfully updated entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {
        "id": "text",
        "name": "text",
        "msg": "text",
        "operand": "text",
        "category": "text",
        "subcategory": "text",
        "risk": 0
      }
    ]),
});
const data = await response.json();

Response

200422

{
  "message": "Successfully updated entry"
}

Create Content Filter Rules

Create a complete set of Content Filter Rules for a configuration

POST/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Body

application/json

category*Category

Category of the rule

descriptionDescription

stringnull

id*Id

msg*Message

Log message for this rule

name*Name

operand*Operand

Matching domain(s) regex

risk*Risk Level

Risk level of this rule, between 1 (lowest risk) and 5 (highest risk)

subcategory*Subcategory

Subcategory of the rule

tagsTags List

List of tags to apply

Response

201422

Content Filter Rules created successfully

Body

application/json

message*Message

Information about successful create operation

Example: "Successfully created entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {
        "id": "text",
        "name": "text",
        "msg": "text",
        "operand": "text",
        "category": "text",
        "subcategory": "text",
        "risk": 0
      }
    ]),
});
const data = await response.json();

Response

201422

{
  "message": "Successfully created entry"
}

Delete Content Filter Rules

Delete all Content Filter Rules in a configuration

DELETE/api/v4.0/conf/{config}/content-filter-rules

Path parameters

config*Config

Response

200422

Content Filter Rules deleted successfully

Body

application/json

message*Message

Information about successful delete operation

Example: "Successfully deleted entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "message": "Successfully deleted entry"
}

Get single Content Filter Rule

Get a Content Filter Rule from the specified configuration

GET/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Content Filter Rule retrieved successfully

Body

application/json

category*Category

Category of the rule

descriptionDescription

stringnull

id*Id

msg*Message

Log message for this rule

name*Name

operand*Operand

Matching domain(s) regex

risk*Risk Level

Risk level of this rule, between 1 (lowest risk) and 5 (highest risk)

subcategory*Subcategory

Subcategory of the rule

tagsTags List

List of tags to apply

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "category": "text",
  "description": "text",
  "id": "text",
  "msg": "text",
  "name": "text",
  "operand": "text",
  "risk": 0,
  "subcategory": "text",
  "tags": [
    "text"
  ]
}

Modify a single Content Filter Rule

Update an individual Content Filter Rule within a configuration

PUT/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

category*Category

Category of the rule

descriptionDescription

stringnull

id*Id

msg*Message

Log message for this rule

name*Name

operand*Operand

Matching domain(s) regex

risk*Risk Level

Risk level of this rule, between 1 (lowest risk) and 5 (highest risk)

subcategory*Subcategory

Subcategory of the rule

tagsTags List

List of tags to apply

Response

200422

Content Filter Rule updated successfully

Body

application/json

message*Message

Information about successful update operation

Example: "Successfully updated entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "name": "text",
      "msg": "text",
      "operand": "text",
      "category": "text",
      "subcategory": "text",
      "risk": 0
    }),
});
const data = await response.json();

Response

200422

{
  "message": "Successfully updated entry"
}

Create single Content Filter Rule

Create an individual Content Filter Rule within a configuration

POST/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Body

application/json

category*Category

Category of the rule

descriptionDescription

stringnull

id*Id

msg*Message

Log message for this rule

name*Name

operand*Operand

Matching domain(s) regex

risk*Risk Level

Risk level of this rule, between 1 (lowest risk) and 5 (highest risk)

subcategory*Subcategory

Subcategory of the rule

tagsTags List

List of tags to apply

Response

201422

Content Filter Rule created successfully

Body

application/json

message*Message

Information about successful create operation

Example: "Successfully created entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "name": "text",
      "msg": "text",
      "operand": "text",
      "category": "text",
      "subcategory": "text",
      "risk": 0
    }),
});
const data = await response.json();

Response

201422

{
  "message": "Successfully created entry"
}

Delete single Content Filter Rule

Delete an individual Content Filter Rule from the specified configuration

DELETE/api/v4.0/conf/{config}/content-filter-rules/{entry_id}

Path parameters

config*Config

entry_id*Entry

Response

200422

Content Filter Rule deleted successfully

Body

application/json

message*Message

Information about successful delete operation

Example: "Successfully deleted entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/{entry_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "message": "Successfully deleted entry"
}

Get Content Filter Rules version list

Get list of versions of Content Filter Rules in a configuration

GET/api/v4.0/conf/{config}/content-filter-rules/versions

Path parameters

config*Config

Response

200422

Content Filter Rules version list retrieved successfully

Body

application/json

totalinteger

Example: 1

itemsarray of VersionEntry

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/versions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "total": 1,
  "items": [
    {
      "author": "text",
      "email": "[e-mail]",
      "message": "text",
      "date": "2024-12-21T12:13:40.149Z",
      "version": "42bcc1282349db1e5791484c3d69420b1d8a8bc1",
      "parents": [
        "f44073242093228b45bff7eb7a065559fa9b46aa"
      ]
    }
  ]
}

Get version of Content Filter Rule set

Get a specific version of a Content Filter Rule set

GET/api/v4.0/conf/{config}/content-filter-rules/versions/{version}

Path parameters

config*Config

version*Version

Response

200422

Content Filter Rule set retrieved successfully

Body

application/json

totalinteger

Example: 1

itemsarray of ContentFilterRule

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/versions/{version}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "total": 1,
  "items": [
    {
      "category": "text",
      "description": "text",
      "id": "text",
      "msg": "text",
      "name": "text",
      "operand": "text",
      "risk": 0,
      "subcategory": "text",
      "tags": [
        "text"
      ]
    }
  ]
}

Revert a Content Filter Rule to the specified version

Set a previous Content Filter Rule version to be the current one

PUT/api/v4.0/conf/{config}/content-filter-rules/versions/{version}/revert

Path parameters

config*Config

version*Version

Response

200422

Content Filter Rule reversion was successful

Body

application/json

message*Message

Information about successful update operation

Example: "Successfully updated entry"

Request

JavaScriptCurlPython

const response = await fetch('/api/v4.0/conf/{config}/content-filter-rules/versions/{version}/revert', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "message": "Successfully updated entry"
}