CTIX
Network live
CTIXPUT

Update Tag

Source docs
PUThttps://cs-testv2.cyware.com/ctixapi/ingestion/tags/{tag_id}/

Updates the name and color-code of a tag.

Path Parameters

NameTypeRequiredDescription
tag_idstringoptional

Pass the ID of a tag to update the details.

Body Parameters

NameTypeRequiredDescription
namestringoptional

Pass the name of the tag within 50 characters.

colour_codestringoptional

Pass the HEX key of a color code for the tag.

Run it

Use the Request parameters panel to enter path IDs, query values, JSON body, and credentials. Then run any snippet below — all languages use the same values. Base URL: https://cs-testv2.cyware.com/ctixapi (change in API Settings).

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.

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
Request body (JSON)Valid JSON
cURL
curl --request PUT \
  --url "https://cs-testv2.cyware.com/ctixapi/ingestion/tags/8818f140-62c6-4dee-bfb2-bc26bde9dfa1/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E" \
  --data '{
  "name": "SuperMalware",
  "colour_code": "#5236E2"
}'

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

JavaScript
const url = "https://cs-testv2.cyware.com/ctixapi/ingestion/tags/8818f140-62c6-4dee-bfb2-bc26bde9dfa1/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E";

const response = await fetch(url, {
  method: "PUT",
  headers: {},
  body: JSON.stringify({
    "name": "SuperMalware",
    "colour_code": "#5236E2"
  }),
});

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/ingestion/tags/8818f140-62c6-4dee-bfb2-bc26bde9dfa1/"
params = {
    "AccessID": "<your access id>",
    "Signature": "<your signature>",
    "Expires": "<your expires>"
}
headers = {}
payload = {
  "name": "SuperMalware",
  "colour_code": "#5236E2"
}
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
{
  "name": "SuperMalware",
  "colour_code": "#5236E2"
}

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

Example Response
{
  "id": "21043a6f-9810-4ec8-92d4-7e0e1d308b8e",
  "name": "SuperMalware",
  "colour_code": "#5236E2",
  "created": "2021-08-07T19:37:37.559473Z",
  "created_by": {},
  "modified_by": {},
  "modified": "2021-08-07T20:31:18.096816Z",
  "tag_type": "manual"
}

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