ProductSearchCTIX

Network live

CTIXPUT

Update Reason

PUThttps://cs-testv2.cyware.com/ctixapi/conversion/allowed_indicators/reasons/{reason_id}/

Updates a particular reason to add an indicator to the allowed list.

Path Parameters

Name	Type	Required	Description
reason_id	string	optional	Pass the unique ID of the reason object.

Body Parameters

Name	Type	Required	Description
id	string	optional	Returns a success or failure message.
created	number	optional	Pass the date and time when the reason was created.
modified	number	optional	Pass the date and time when the reason was modified.
created_by	string	optional	Pass the ID of the user that created the reason.
modified_by	string	optional	Pass the ID of the user who modified the reason.
reason	string	optional	Pass the updated reason of the allowed indicator.
is_active	boolean	optional	Pass true if the reason is active, else pass false.
whitelist	string	optional	Pass the unique ID of the allowed indicator.

Playground

Request parameters

Edit values here before running any snippet below (cURL, JavaScript, or Python). Code blocks are reference only — your inputs above are what gets sent.

CTIXConnect to Intel ExchangeRequired to change data

Credentials required for PUT

Open API (HMAC signature) · Get credentials from Cyware Admin → Open API → Generate Credentials.

Base URL

Access ID *Secret Key *

Signature and Expires are generated when you run a request. Access ID and Secret Key stay in memory for this tab only.

Credentials from Authentication auto-fill here for this product. If fields are empty after connecting, refresh this page or open the product docs again.

Path Parameters

reason_id (in URL)

Request body (JSON)Valid JSON

cURL

curl --request PUT \
  --url "https://cs-testv2.cyware.com/ctixapi/conversion/allowed_indicators/reasons/d2cf6961-716a-405e-8ca7-bd8ac20567c1/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E" \
  --data '{
  "id": "83f2efb5-ca0d-4400-bad2-baf4b7361532",
  "created": 1641492061,
  "modified": 1641492061,
  "created_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "modified_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "reason": "test reason -whitelist-updated",
  "is_active": true,
  "whitelist": "8af39afb-6503-4f57-a347-4b42475abd59"
}'

View-only example — running live API calls requires a role with snippet testing access.

JavaScript

const url = "https://cs-testv2.cyware.com/ctixapi/conversion/allowed_indicators/reasons/d2cf6961-716a-405e-8ca7-bd8ac20567c1/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E";

const response = await fetch(url, {
  method: "PUT",
  headers: {},
  body: JSON.stringify({
    "id": "83f2efb5-ca0d-4400-bad2-baf4b7361532",
    "created": 1641492061,
    "modified": 1641492061,
    "created_by": "6063f29f-0224-4891-8761-34ef988fa080",
    "modified_by": "6063f29f-0224-4891-8761-34ef988fa080",
    "reason": "test reason -whitelist-updated",
    "is_active": true,
    "whitelist": "8af39afb-6503-4f57-a347-4b42475abd59"
  }),
});

const text = await response.text();
let data;
try { data = JSON.parse(text); } catch { data = text; }
console.log(response.status, data);

View-only example — running live API calls requires a role with snippet testing access.

Python

import requests

url = "https://cs-testv2.cyware.com/ctixapi/conversion/allowed_indicators/reasons/d2cf6961-716a-405e-8ca7-bd8ac20567c1/"
params = {
    "AccessID": "<your access id>",
    "Signature": "<your signature>",
    "Expires": "<your expires>"
}
headers = {}
payload = {
  "id": "83f2efb5-ca0d-4400-bad2-baf4b7361532",
  "created": 1641492061,
  "modified": 1641492061,
  "created_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "modified_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "reason": "test reason -whitelist-updated",
  "is_active": true,
  "whitelist": "8af39afb-6503-4f57-a347-4b42475abd59"
}
response = requests.request("PUT", url, params=params, headers=headers, json=payload)
print(response.status_code)
print(response.text)

View-only example — running live API calls requires a role with snippet testing access.

Request Body

{
  "id": "83f2efb5-ca0d-4400-bad2-baf4b7361532",
  "created": 1641492061,
  "modified": 1641492061,
  "created_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "modified_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "reason": "test reason -whitelist-updated",
  "is_active": true,
  "whitelist": "8af39afb-6503-4f57-a347-4b42475abd59"
}

View-only example — running live API calls requires a role with snippet testing access.

Example Response

{
  "id": "83f2efb5-ca0d-4400-bad2-baf4b7361532",
  "created": 1641492061,
  "modified": 1641492217,
  "created_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "modified_by": "6063f29f-0224-4891-8761-34ef988fa080",
  "reason": "test reason -whitelist-updated",
  "is_active": true,
  "whitelist": "8af39afb-6503-4f57-a347-4b42475abd59"
}

View-only example — running live API calls requires a role with snippet testing access.