Update account group
PUT {{baseUrl}}/account-groups/:id?expand=user
Updates an account group using its ID. You can modify the account group’s name or the list of agents assigned to the account group.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
expand | string | Optional parameter that specifies whether or not account group related resources should be expanded. By default, no expansion takes place if the query parameter is not passed. For example, to expand the users resource, pass the ?expand=user query. |
Request Body
{"accountGroupName"=>"My testing account group", "agents"=>["105", "719"]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"aid":"1234","accountGroupName":"Account A","isCurrentAccountGroup":true,"isDefaultAccountGroup":true,"organizationName":"pariatur culpa fugiat","users":[{"name":"User X","email":"userx@thousandeyes.com","uid":"235","lastLogin":"2022-07-17T22:00:54Z","dateRegistered":"2022-07-17T22:00:54Z","roles":[{"name":"Organization Admin","roleId":"35","isBuiltin":true,"hasManagementPermissions":false},{"name":"Organization Admin","roleId":"35","isBuiltin":false,"hasManagementPermissions":true}]},{"name":"User X","email":"userx@thousandeyes.com","uid":"235","lastLogin":"2022-07-17T22:00:54Z","dateRegistered":"2022-07-17T22:00:54Z","roles":[{"name":"Organization Admin","roleId":"35","isBuiltin":true,"hasManagementPermissions":true},{"name":"Organization Admin","roleId":"35","isBuiltin":true,"hasManagementPermissions":true}]}],"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"dol","deprecation":"fugiat in Excepteur exercitation","name":"dolor officia ut c","profile":"incididunt id ad","title":"nisi","hreflang":"in ipsum"}},"agents":[{"agentType":"enterprise-cluster","ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","location":"San Francisco Bay Area","countryId":"US","enabled":true,"prefix":"99.128.0.0/11","verifySslCertificates":true,"clusterMembers":[{"ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","memberId":"10","name":"Cluster member name","errorDetails":[{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"},{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"}],"lastSeen":"2022-07-17T22:00:54Z","agentState":"online","targetForTests":"1.1.1.1","utilization":25},{"ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","memberId":"10","name":"Cluster member name","errorDetails":[{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"},{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"}],"lastSeen":"2022-07-17T22:00:54Z","agentState":"online","targetForTests":"1.1.1.1","utilization":25}],"utilization":25,"accountGroups":[{"aid":"1234","accountGroupName":"Account A"},{"aid":"1234","accountGroupName":"Account A"}],"ipv6Policy":"force-ipv4","errorDetails":[{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"},{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"}],"hostname":"thousandeyes.com","lastSeen":"2022-07-17T22:00:54Z","agentState":"online","keepBrowserCache":true,"createdDate":"2022-07-17T22:00:54Z","targetForTests":"1.1.1.1","localResolutionPrefixes":["10.2.3.3/24","10.2.3.3/24"],"interfaceIpMappings":[{"interfaceName":"wlp4s0","ipAddresses":["73.252.207.219","2601:646:300:3ae0::b977"]},{"interfaceName":"wlp4s0","ipAddresses":["73.252.207.219","2601:646:300:3ae0::b977"]}]},{"agentType":"enterprise-cluster","ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","location":"San Francisco Bay Area","countryId":"US","enabled":true,"prefix":"99.128.0.0/11","verifySslCertificates":true,"clusterMembers":[{"ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","memberId":"10","name":"Cluster member name","errorDetails":[{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"},{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"}],"lastSeen":"2022-07-17T22:00:54Z","agentState":"online","targetForTests":"1.1.1.1","utilization":25},{"ipAddresses":["99.139.65.220","9bbd:8a0a:a257:5876:288b:6cb2:3f36:64ce"],"publicIpAddresses":["192.168.1.78","f9b2:3a21:f25c:d300:03f4:586d:f8d6:4e1c"],"network":"AT\u0026T Services, Inc. (AS 7018)","memberId":"10","name":"Cluster member name","errorDetails":[{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"},{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"}],"lastSeen":"2022-07-17T22:00:54Z","agentState":"online","targetForTests":"1.1.1.1","utilization":25}],"utilization":25,"accountGroups":[{"aid":"1234","accountGroupName":"Account A"},{"aid":"1234","accountGroupName":"Account A"}],"ipv6Policy":"force-ipv4","errorDetails":[{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"},{"code":"agent-version-outdated","description":"Agent Version 0.1.1 (latest: 1.0.0)"}],"hostname":"thousandeyes.com","lastSeen":"2022-07-17T22:00:54Z","agentState":"online","keepBrowserCache":true,"createdDate":"2022-07-17T22:00:54Z","targetForTests":"1.1.1.1","localResolutionPrefixes":["10.2.3.3/24","10.2.3.3/24"],"interfaceIpMappings":[{"interfaceName":"wlp4s0","ipAddresses":["73.252.207.219","2601:646:300:3ae0::b977"]},{"interfaceName":"wlp4s0","ipAddresses":["73.252.207.219","2601:646:300:3ae0::b977"]}]}],"accountToken":"6j052y4vfgyuhefghue"}