ProductSearchCTIX

Network live

CTIXPUT

Update Tag Group

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

Update all fields of an existing tag group with new values.

Path Parameters

Name	Type	Required	Description
tag_id	String	optional	Pass the ID of a tag group to retrieve the details.

Body Parameters

Name	Type	Required	Description
name	string	required	Pass the name of the tag group.
description	string	optional	Pass the description of the tag group.
tag_type	object	required	Pass the details of the tag type.
associated_tags	array	required	Pass a list of associated tags.
is_active	boolean	optional	Pass true if the tag group is active in Intel Exchange.

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

tag_id (in URL)

Request body (JSON)Valid JSON

cURL

curl --request PUT \
  --url "https://cs-testv2.cyware.com/ctixapi/ingestion/tags/{tag_id}/?AccessID=%3Cyour%20access%20id%3E&Signature=%3Cyour%20signature%3E&Expires=%3Cyour%20expires%3E" \
  --data '{
  "name": "AS Group",
  "description": "Ransomware AS Check",
  "tag_type": {},
  "associated_tags": [
    {}
  ],
  "is_active": true
}'

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/{tag_id}/?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": "AS Group",
    "description": "Ransomware AS Check",
    "tag_type": {},
    "associated_tags": [
      {}
    ],
    "is_active": true
  }),
});

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/{tag_id}/"
params = {
    "AccessID": "<your access id>",
    "Signature": "<your signature>",
    "Expires": "<your expires>"
}
headers = {}
payload = {
  "name": "AS Group",
  "description": "Ransomware AS Check",
  "tag_type": {},
  "associated_tags": [
    {}
  ],
  "is_active": true
}
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": "AS Group",
  "description": "Ransomware AS Check",
  "tag_type": {},
  "associated_tags": [
    {}
  ],
  "is_active": true
}

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

Example Response

{
  "id": "8b523365-34c3-49d6-890a-e8015b927d45",
  "name": "AS Group",
  "colour_code": "#DCDEE4",
  "created": 1760440627,
  "created_by": "70f3d3ee-b7bc-4ceb-849e-16db0de5278b",
  "modified_by": "70f3d3ee-b7bc-4ceb-849e-16db0de5278b",
  "modified": 1760511178,
  "tag_type": {},
  "is_active": true,
  "groups": [],
  "description": "Ransomware AS Check",
  "theme": "white",
  "icon": "cyicon-tags-solid",
  "associated_tags_count": 1,
  "associated_tags": [
    {}
  ]
}

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