Update Traffic Control
curl --request PUT \
--url https://api.eflow.team/v1/networks/trafficcontrols/{controlId} \
--header 'Content-Type: application/json' \
--header 'X-Eflow-Api-Key: <api-key>' \
--data '
{
"network_traffic_control_id": 1,
"name": "Block Bad Sources",
"status": "active",
"control_type": "blacklist",
"targeting_action": "block",
"comparison_method": "exact_match",
"is_apply_all_affiliates": false,
"is_apply_all_offers": false,
"variables": [
"source_id",
"sub3"
],
"network_offer_ids": [
5
],
"network_affiliate_ids": [
7,
14,
21
],
"network_advertiser_ids": [],
"values": [
"bad_source_1",
"bad_source_2"
]
}
'import requests
url = "https://api.eflow.team/v1/networks/trafficcontrols/{controlId}"
payload = {
"network_traffic_control_id": 1,
"name": "Block Bad Sources",
"status": "active",
"control_type": "blacklist",
"targeting_action": "block",
"comparison_method": "exact_match",
"is_apply_all_affiliates": False,
"is_apply_all_offers": False,
"variables": ["source_id", "sub3"],
"network_offer_ids": [5],
"network_affiliate_ids": [7, 14, 21],
"network_advertiser_ids": [],
"values": ["bad_source_1", "bad_source_2"]
}
headers = {
"X-Eflow-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-Eflow-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
network_traffic_control_id: 1,
name: 'Block Bad Sources',
status: 'active',
control_type: 'blacklist',
targeting_action: 'block',
comparison_method: 'exact_match',
is_apply_all_affiliates: false,
is_apply_all_offers: false,
variables: ['source_id', 'sub3'],
network_offer_ids: [5],
network_affiliate_ids: [7, 14, 21],
network_advertiser_ids: [],
values: ['bad_source_1', 'bad_source_2']
})
};
fetch('https://api.eflow.team/v1/networks/trafficcontrols/{controlId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eflow.team/v1/networks/trafficcontrols/{controlId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'network_traffic_control_id' => 1,
'name' => 'Block Bad Sources',
'status' => 'active',
'control_type' => 'blacklist',
'targeting_action' => 'block',
'comparison_method' => 'exact_match',
'is_apply_all_affiliates' => false,
'is_apply_all_offers' => false,
'variables' => [
'source_id',
'sub3'
],
'network_offer_ids' => [
5
],
'network_affiliate_ids' => [
7,
14,
21
],
'network_advertiser_ids' => [
],
'values' => [
'bad_source_1',
'bad_source_2'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Eflow-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.eflow.team/v1/networks/trafficcontrols/{controlId}"
payload := strings.NewReader("{\n \"network_traffic_control_id\": 1,\n \"name\": \"Block Bad Sources\",\n \"status\": \"active\",\n \"control_type\": \"blacklist\",\n \"targeting_action\": \"block\",\n \"comparison_method\": \"exact_match\",\n \"is_apply_all_affiliates\": false,\n \"is_apply_all_offers\": false,\n \"variables\": [\n \"source_id\",\n \"sub3\"\n ],\n \"network_offer_ids\": [\n 5\n ],\n \"network_affiliate_ids\": [\n 7,\n 14,\n 21\n ],\n \"network_advertiser_ids\": [],\n \"values\": [\n \"bad_source_1\",\n \"bad_source_2\"\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-Eflow-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.eflow.team/v1/networks/trafficcontrols/{controlId}")
.header("X-Eflow-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"network_traffic_control_id\": 1,\n \"name\": \"Block Bad Sources\",\n \"status\": \"active\",\n \"control_type\": \"blacklist\",\n \"targeting_action\": \"block\",\n \"comparison_method\": \"exact_match\",\n \"is_apply_all_affiliates\": false,\n \"is_apply_all_offers\": false,\n \"variables\": [\n \"source_id\",\n \"sub3\"\n ],\n \"network_offer_ids\": [\n 5\n ],\n \"network_affiliate_ids\": [\n 7,\n 14,\n 21\n ],\n \"network_advertiser_ids\": [],\n \"values\": [\n \"bad_source_1\",\n \"bad_source_2\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eflow.team/v1/networks/trafficcontrols/{controlId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Eflow-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"network_traffic_control_id\": 1,\n \"name\": \"Block Bad Sources\",\n \"status\": \"active\",\n \"control_type\": \"blacklist\",\n \"targeting_action\": \"block\",\n \"comparison_method\": \"exact_match\",\n \"is_apply_all_affiliates\": false,\n \"is_apply_all_offers\": false,\n \"variables\": [\n \"source_id\",\n \"sub3\"\n ],\n \"network_offer_ids\": [\n 5\n ],\n \"network_affiliate_ids\": [\n 7,\n 14,\n 21\n ],\n \"network_advertiser_ids\": [],\n \"values\": [\n \"bad_source_1\",\n \"bad_source_2\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"network_traffic_control_id": 1,
"network_id": 1,
"name": "Block Bad Sources",
"status": "active",
"is_apply_all_affiliates": false,
"is_apply_all_offers": false,
"control_type": "blacklist",
"targeting_action": "block",
"date_valid_from": "",
"date_valid_to": "",
"comparison_method": "exact_match",
"variables": [
"source_id",
"sub3"
],
"time_created": 1774721611,
"time_saved": 1774721633,
"relationship": {
"network_offer_ids": [
5
],
"network_affiliate_ids": [
7,
14,
21
],
"network_advertiser_ids": null,
"values": [
"bad_source_1",
"bad_source_2"
]
}
}Traffic Controls
Update Traffic Control
Update an existing traffic control. This is a full object replacement.
PUT
/
networks
/
trafficcontrols
/
{controlId}
Update Traffic Control
curl --request PUT \
--url https://api.eflow.team/v1/networks/trafficcontrols/{controlId} \
--header 'Content-Type: application/json' \
--header 'X-Eflow-Api-Key: <api-key>' \
--data '
{
"network_traffic_control_id": 1,
"name": "Block Bad Sources",
"status": "active",
"control_type": "blacklist",
"targeting_action": "block",
"comparison_method": "exact_match",
"is_apply_all_affiliates": false,
"is_apply_all_offers": false,
"variables": [
"source_id",
"sub3"
],
"network_offer_ids": [
5
],
"network_affiliate_ids": [
7,
14,
21
],
"network_advertiser_ids": [],
"values": [
"bad_source_1",
"bad_source_2"
]
}
'import requests
url = "https://api.eflow.team/v1/networks/trafficcontrols/{controlId}"
payload = {
"network_traffic_control_id": 1,
"name": "Block Bad Sources",
"status": "active",
"control_type": "blacklist",
"targeting_action": "block",
"comparison_method": "exact_match",
"is_apply_all_affiliates": False,
"is_apply_all_offers": False,
"variables": ["source_id", "sub3"],
"network_offer_ids": [5],
"network_affiliate_ids": [7, 14, 21],
"network_advertiser_ids": [],
"values": ["bad_source_1", "bad_source_2"]
}
headers = {
"X-Eflow-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-Eflow-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
network_traffic_control_id: 1,
name: 'Block Bad Sources',
status: 'active',
control_type: 'blacklist',
targeting_action: 'block',
comparison_method: 'exact_match',
is_apply_all_affiliates: false,
is_apply_all_offers: false,
variables: ['source_id', 'sub3'],
network_offer_ids: [5],
network_affiliate_ids: [7, 14, 21],
network_advertiser_ids: [],
values: ['bad_source_1', 'bad_source_2']
})
};
fetch('https://api.eflow.team/v1/networks/trafficcontrols/{controlId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eflow.team/v1/networks/trafficcontrols/{controlId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'network_traffic_control_id' => 1,
'name' => 'Block Bad Sources',
'status' => 'active',
'control_type' => 'blacklist',
'targeting_action' => 'block',
'comparison_method' => 'exact_match',
'is_apply_all_affiliates' => false,
'is_apply_all_offers' => false,
'variables' => [
'source_id',
'sub3'
],
'network_offer_ids' => [
5
],
'network_affiliate_ids' => [
7,
14,
21
],
'network_advertiser_ids' => [
],
'values' => [
'bad_source_1',
'bad_source_2'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Eflow-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.eflow.team/v1/networks/trafficcontrols/{controlId}"
payload := strings.NewReader("{\n \"network_traffic_control_id\": 1,\n \"name\": \"Block Bad Sources\",\n \"status\": \"active\",\n \"control_type\": \"blacklist\",\n \"targeting_action\": \"block\",\n \"comparison_method\": \"exact_match\",\n \"is_apply_all_affiliates\": false,\n \"is_apply_all_offers\": false,\n \"variables\": [\n \"source_id\",\n \"sub3\"\n ],\n \"network_offer_ids\": [\n 5\n ],\n \"network_affiliate_ids\": [\n 7,\n 14,\n 21\n ],\n \"network_advertiser_ids\": [],\n \"values\": [\n \"bad_source_1\",\n \"bad_source_2\"\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-Eflow-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.eflow.team/v1/networks/trafficcontrols/{controlId}")
.header("X-Eflow-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"network_traffic_control_id\": 1,\n \"name\": \"Block Bad Sources\",\n \"status\": \"active\",\n \"control_type\": \"blacklist\",\n \"targeting_action\": \"block\",\n \"comparison_method\": \"exact_match\",\n \"is_apply_all_affiliates\": false,\n \"is_apply_all_offers\": false,\n \"variables\": [\n \"source_id\",\n \"sub3\"\n ],\n \"network_offer_ids\": [\n 5\n ],\n \"network_affiliate_ids\": [\n 7,\n 14,\n 21\n ],\n \"network_advertiser_ids\": [],\n \"values\": [\n \"bad_source_1\",\n \"bad_source_2\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eflow.team/v1/networks/trafficcontrols/{controlId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Eflow-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"network_traffic_control_id\": 1,\n \"name\": \"Block Bad Sources\",\n \"status\": \"active\",\n \"control_type\": \"blacklist\",\n \"targeting_action\": \"block\",\n \"comparison_method\": \"exact_match\",\n \"is_apply_all_affiliates\": false,\n \"is_apply_all_offers\": false,\n \"variables\": [\n \"source_id\",\n \"sub3\"\n ],\n \"network_offer_ids\": [\n 5\n ],\n \"network_affiliate_ids\": [\n 7,\n 14,\n 21\n ],\n \"network_advertiser_ids\": [],\n \"values\": [\n \"bad_source_1\",\n \"bad_source_2\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"network_traffic_control_id": 1,
"network_id": 1,
"name": "Block Bad Sources",
"status": "active",
"is_apply_all_affiliates": false,
"is_apply_all_offers": false,
"control_type": "blacklist",
"targeting_action": "block",
"date_valid_from": "",
"date_valid_to": "",
"comparison_method": "exact_match",
"variables": [
"source_id",
"sub3"
],
"time_created": 1774721611,
"time_saved": 1774721633,
"relationship": {
"network_offer_ids": [
5
],
"network_affiliate_ids": [
7,
14,
21
],
"network_advertiser_ids": null,
"values": [
"bad_source_1",
"bad_source_2"
]
}
}Authorizations
The Everflow API key generated from the Control Center > Security.
Path Parameters
The unique traffic control ID to update.
Body
application/json
The ID of the traffic control to update.
Name of the traffic control.
Status of the traffic control. Can be one of the following values: active or inactive.
Available options:
active, inactive Traffic controls can be either whitelist or blacklist.
Available options:
blacklist, whitelist The targeting action can be either block or fail_traffic.
Available options:
block, fail_traffic Defines how the variables will be compared.
Available options:
exact_match, contains, begins_with, ends_with, does_not_contain, does_not_match, is_empty When this is false, the network_affiliate_ids array must be filled.
When this is false, the network_offer_ids or network_advertiser_ids array must be filled.
The click variable that will be looked up and compared to the values supplied. Can be one or multiple values among: sub1, sub2, sub3, sub4, sub5, sub6, sub7, sub8, sub9, sub10, source_id, referrer, isp, ip, user_agent, country, tracking_domain.
Available options:
sub1, sub2, sub3, sub4, sub5, sub6, sub7, sub8, sub9, sub10, source_id, referrer, isp, ip, user_agent, country, tracking_domain The values that the traffic control will filter. Limited to 3000 values when using exact_match and 100 values otherwise. Please note that when using a whitelist, all values besides the ones specified here will be blocked / sent to fail traffic.
The offers IDs that will be affected by the traffic control (only relevant when is_apply_all_offers is set to false).
The affiliate IDs that will be affected by the traffic control (only relevant when is_apply_all_affiliates is set to false).
The advertiser IDs that will be affected by the traffic control (only relevant when is_apply_all_offers is set to false). All offers for the specified advertiser IDs will be affected.
An optional start date after which the traffic control will be enforced. Use the YYYY-MM-DD format.
An optional end date after which the traffic control will no longer be enforced. Use the YYYY-MM-DD format.
Response
Unique traffic control ID.
Network ID.
Name of the traffic control.
Status of the traffic control.
Available options:
active, inactive Traffic controls can be either whitelist or blacklist.
Available options:
blacklist, whitelist The targeting action.
Available options:
block, fail_traffic Whether this control applies to all offers.
Whether this control applies to all affiliates.
Defines how the variables are compared.
Available options:
exact_match, contains, begins_with, ends_with, does_not_contain, does_not_match, is_empty The click variable that will be looked up and compared to the values supplied. Can be one or multiple values among: sub1, sub2, sub3, sub4, sub5, sub6, sub7, sub8, sub9, sub10, source_id, referrer, isp, ip, user_agent, country, tracking_domain. Note: variables and values are only populated by the Get by ID endpoint.
Available options:
sub1, sub2, sub3, sub4, sub5, sub6, sub7, sub8, sub9, sub10, source_id, referrer, isp, ip, user_agent, country, tracking_domain Related entities associated with this traffic control.
Show child attributes
Show child attributes
Start date for the control's validity period (YYYY-MM-DD).
End date for the control's validity period (YYYY-MM-DD).
Unix timestamp of creation.
Example:
1734455015
Unix timestamp of last update.
Example:
1734455015
Was this page helpful?