Account Groups Endpoint Launch on v3 API

With this update the Cloudability Account Groups end point is available on the v3 API. This is the third of six endpoints being launched on Cloudability’s latest-gen public API this month.

Account Groups function like tags for AWS accounts, Azure Subscriptions and GCP projects, allowing customers to define reporting dimensions within Cloudability for concepts such as environment, team and business unit. This API endpoint enables admins to perform programmatic “CRUD-ing” of their organization’s Account Groups, creating, retrieving, updating, and deleting Account Groups so that all users can leverage the generated dimensions in dashboards and reports.

Migrating between v1 and v3 of the Account Groups API end point is straightforward as the URL parameters and JSON payloads remain consistent.

Example request

To retrieve an existing Account Group simply run a HTTP GET request at https://api.cloudability.com/v3/account_groups/:id
Figure: retrieving an account group via the v3 API

General considerations when moving from v1 to v3 API end points

Individual API documents have been added to the v3 user documentation for each endpoint. Changes at the endpoint interface level between v1 and v3 are reflected within the endpoint documentation.

Some general differences between the v1 and v3 APIs:

• Base URL: https://app.cloudability.com/api/1/ https://api.cloudability.com/v3/
• Authentication: standard method for v1 is via URL query parameter while v3 is via Basic Auth HTTP header.
• Rate Limiting: the v3 API is limited to 300 calls per minute for each user

Stay tuned as the complete set of end points becomes available on the v3 API

Look out for further updates as our engineering team launches the complete set of endpoints on the v3 API. Announcements will also be made regarding the future of the v1 API.