Connector Release 2.10 API
June 16, 2025
Before understanding the API release highlights, learn more about the API server URL to be used in your API requests by referring to the Know Your Qualys API Server URL section. For this API Release Notes, <qualys_base_url> is mentioned in the sample API requests.
Assign Tags
New or Updated API | New |
API Endpoint | connectors/v1.0/{cloudType}/assignTags |
Method | PUT |
DTD or XSD changes | Not Applicable |
This API can be used to assign or override tags on cloud connectors across AWS, Azure, and GCP environments. It enables consistent tagging and classification of connectors for reporting, filtering, and automation purposes.
Input ParameterInput Parameter
Parameter Name | Mandatory/Optional | Data Type | Description |
---|---|---|---|
cloudtype | Mandatory | String | Specify the cloud provider name. Accepted values: "AWS", "AZURE","GCP". |
tagNames | Mandatory | String | List of tag names to assign to connectors. |
connectorIds | Mandatory | String | List of connector IDs to which tags apply. |
Sample Sample
API Request
curl --location '<Qualys_Base_URL>connectors/v1.0/AZURE/assignTags' --header 'Authorization: Bearer <Bearer Token>' \ --header 'Accept: application/json'
Request Body
{ "tagNames": [ "Cloud Agent" ], "connectorIds": [ 64007 ] }
API Response
{ "success": [ { "tagId": 7542921, "tagName": "Cloud Agent", "connectorIds": [ 64007 ] } ], "status": "success" }