---
title: "New Asset Group Endpoint"
date: "2023-02-27T15:04:49+00:00"
summary:
image:
type: "article"
url: "/acquia-dam/help/90076-new-asset-group-endpoint"
id: "375d5fd4-fa20-450e-9e49-fc50ad73a799"
---

Version 1.0 of the Acquia DAM API has long had the ability to return information about asset groups in your Collective app. This same asset group information is now being returned in version 2.0. Custom integrations use asset group endpoints to help organize and permission assets.

The [following endpoint](https://widenv2.docs.apiary.io/#reference/assets/asset-group-list/get-asset-groups) is now available for use in v2.0 of the API:

*   `GET /v2/assets/assetgroups`

This endpoint is functionally identical to the `/api/rest/assetgroups` endpoint in v1.0, but now has added reliability and durability to ensure integrations will get accurate information.

Migration
---------

If an integration is already using the endpoint in v1.0, then a simple migration should be performed. To do that:

1.  Change the endpoint:
    1.  From `https://mysite.widencollective.com/api/rest/assetgroups`
    2.  To `https://api.widencollective.com/v2/assets/assetgroups`
2.  Change the response data field from `assetGroups` to `items`. See examples below:

### Examples

v1.0 response shape:

    {
     "assetGroups": [
     {
     "uuid": "f4aed450-886f-469f-9e8e-5bd5768216c3",
     "name": "Guest Pass Uploads"
     },
     {
     "uuid": "a4e15933-a240-4a6b-8e61-e876148feb4a",
     "name": "mobile"
     }
     ]
    }
    

v2.0 response shape:

    {
     "item_type": "assetgroup",
     "total_count": 2,
     "items": [
     {
     "uuid": "f4aed450-886f-469f-9e8e-5bd5768216c3",
     "name": "Guest Pass Uploads"
     },
     {
     "uuid": "a4e15933-a240-4a6b-8e61-e876148feb4a",
     "name": "mobile"
     }
     ]
    }
    

An in-depth look is available in our [API documentation](https://widenv2.docs.apiary.io/#reference/assets/asset-group-list/get-asset-groups). Please don't hesitate to reach out to our [Support team](https://community.widen.com/) with any questions.