---
title: "Update Traffic Control"
method: PUT
path: "/networks/trafficcontrols/{controlId}"
tags: ["Traffic Controls"]
---

# Update Traffic Control

`PUT /networks/trafficcontrols/{controlId}`

Update an existing traffic control. This is a full object replacement.

## Path parameters

- `controlId` integer, required

## Request body

- object
  - `network_traffic_control_id` integer, required — The ID of the traffic control to update.
  - `name` string, required — Name of the traffic control.
  - `status` 'active' | 'inactive', required — Status of the traffic control. Can be one of the following values: active or inactive.
  - `control_type` 'blacklist' | 'whitelist', required — Traffic controls can be either `whitelist` or `blacklist`.
  - `targeting_action` 'block' | 'fail_traffic', required — The targeting action can be either `block` or `fail_traffic`.
  - `comparison_method` 'exact_match' | 'contains' | 'begins_with' | 'ends_with' | 'does_not_contain' | 'does_not_match' | 'is_empty', required — Defines how the variables will be compared.
  - `is_apply_all_affiliates` boolean, required — When this is false, the `network_affiliate_ids` array must be filled.
  - `is_apply_all_offers` boolean, required — When this is false, the `network_offer_ids` or `network_advertiser_ids` array must be filled.
  - `variables` string[], required — 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`.
  - `values` string[], required — 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.
  - `network_offer_ids` integer[] — The offers IDs that will be affected by the traffic control (only relevant when `is_apply_all_offers` is set to false).
  - `network_affiliate_ids` integer[] — The affiliate IDs that will be affected by the traffic control (only relevant when `is_apply_all_affiliates` is set to false).
  - `network_advertiser_ids` integer[] — 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.
  - `date_valid_from` string — An optional start date after which the traffic control will be enforced. Use the YYYY-MM-DD format.
  - `date_valid_to` string — An optional end date after which the traffic control will no longer be enforced. Use the YYYY-MM-DD format.

## Response `200`

- TrafficControl
  - `network_traffic_control_id` integer — Unique traffic control ID.
  - `network_id` integer — Network ID.
  - `name` string — Name of the traffic control.
  - `status` 'active' | 'inactive' — Status of the traffic control.
  - `control_type` 'blacklist' | 'whitelist' — Traffic controls can be either whitelist or blacklist.
  - `targeting_action` 'block' | 'fail_traffic' — The targeting action.
  - `is_apply_all_offers` boolean — Whether this control applies to all offers.
  - `is_apply_all_affiliates` boolean — Whether this control applies to all affiliates.
  - `comparison_method` 'exact_match' | 'contains' | 'begins_with' | 'ends_with' | 'does_not_contain' | 'does_not_match' | 'is_empty' — Defines how the variables are compared.
  - `variables` string[] — 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.
  - `relationship` object — Related entities associated with this traffic control.
    - `network_offer_ids` integer[], nullable — Offer IDs this control applies to.
    - `network_affiliate_ids` integer[], nullable — Affiliate IDs this control applies to.
    - `network_advertiser_ids` integer[], nullable — Advertiser IDs this control applies to.
    - `values` string[] — The blocked/allowed values. Only returned by the Find by ID endpoint.
  - `date_valid_from` string — Start date for the control's validity period (YYYY-MM-DD).
  - `date_valid_to` string — End date for the control's validity period (YYYY-MM-DD).
  - `time_created` integer — Unix timestamp of creation.
  - `time_saved` integer — Unix timestamp of last update.

## Other responses

- `404` — Traffic control not found.

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)