v1

latestOpenAPI 3.0.02026-07-2634192196.8 KB

filtering-rules

Mutate filtering rules

Allows atomic mutation to filtering rules for an environment. Explicitly specify which list (allow or deny) you are mutating and which operation (add or remove) you want to execute with the given list of items. Currently only supports origin domain filtering.

Note: It can take up to 5 minutes to start filtering incoming requests after setting a rule.

patch/filtering-rules

Headers

X-API-Versionstring required

Management API version.

Request body

environmentstring required

ID of an environment for which we are mutating the filtering rules.

permission'allow' | 'deny' required

Permission list we want to mutate, either allow or deny.

op'add' | 'remove' required

Operation we are executing on specified permission list, either add or remove.

itemsstring[] required

List of items we are mutating with the given operation on the given permission list.

Response

Example response

{
  "data": [
    {
      "type": "origin",
      "environment": "ae_rrETjdWcfqI6AFsk",
      "allow": [
        "example.com",
        "my-website.com"
      ],
      "deny": [
        "*"
      ]
    }
  ]
}