Remove Address Groups

Removes the specified address groups.

HTTP Request

DELETE /api/sonar/address-groups
Request using cURL
curl -H "Authorization: Bearer <API_KEY>" \
     -X DELETE \
     https://HOSTNAME/api/sonar/address-groups?guids=4dc14f3d-ebf8-4032-8a7a-ef9ec6cd3dd2
Request Parameter
KeyRequiredTypeDescriptionNote
guidsOStringAddress group GUIDComma-separated list

Success Response

{
    "failures": []
}

Error Responses

Required argument is missing

HTTP status code 400

{
    "error_code": "null-argument",
    "error_msg": "guids should be not null"
}
Invalid GUID format

HTTP status code 400

{
    "error_code": "invalid-param-type",
    "error_msg": "guids should be guid type."
}
Failed to delete an address group

HTTP status code 200

{
    "failures": [
        {
            "id": "55e6d809-96c8-4d7a-9e20-98e2b34b6cec",
            "reason": "address-group-not-found"
        }
    ]
}
No privileges to delete an address group

HTTP status code 500

{
    "error_code": "illegal-state",
    "error_msg": "no-permission"
}