Remove Address Groups

Removes the specified address groups.

HTTP Request

cURL Example

curl -H "Authorization: Bearer <API_KEY>" \
     -X DELETE \
     https://HOSTNAME/api/sonar/address-groups?guids=4dc14f3d-ebf8-4032-8a7a-ef9ec6cd3dd2

Request Parameter

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