Logo
Akamai APIs API Documentation

List groups

GET https://{{host}}/config-dns/v2/data/groups?gid={{gid}}

Lists the groups accessible to the current user. Each group includes the list of contracts related to that group, as well as your permissions of READ, WRITE, ADD, or DELETE zone on that group.

 

Body PARAM

Key Datatype Required Description 
gid
string (Required) The currently selected group ID to manage.
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "groups": [ { "contractIds": [ "C-0N7RAC71" ], "groupId": 54321, "groupName": "example-name", "permissions": [ "READ", "WRITE", "ADD", "DELETE" ] } ] }



Curl
curl -X GET 'https://undefined/config-dns/v2/data/groups?gid=?gid=&accountSwitchKey=' -H 'Accept: application/json'

ENDPOINTS