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"
}