---
title: "Lists the unassigned user groups of a specific resource group."
method: GET
path: "/accessmanagement/resourcegroups/{resourceGroupId}/usergroups/unassigned"
tags: ["accessmanagement - resource groups"]
---

# Lists the unassigned user groups of a specific resource group.

`GET /accessmanagement/resourcegroups/{resourceGroupId}/usergroups/unassigned`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/accessmanagement/resourcegroups/{resourceGroupId}/usergroups/unassigned`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/accessmanagement/resourcegroups/:resourceGroupId/usergroups/unassigned/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lists the user groups not currently assigned to a specific resource group, helping users identify available groups for assignment.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `400` and `404` error codes with clear descriptions when requests fail.</br>- **Targeted data retrieval:** Employs the `resourceGroupId` parameter to return the specified resource group's unassigned user groups, ensuring accuracy and relevance in the response.

## Path parameters

- `resourceGroupId` integer, required

## Response `200`

User groups listed successfully.

- ResourceUserGroupPaginated
  - `data` ResourceUserGroup[]
    - `id` integer
    - `name` string
    - `description` string
    - `resourceGroupSummary` ResourceUserGroupResourceGroupSummary[]
      - `name` string
      - `id` integer
      - `roles` ServiceKeyResponseFieldsRoles
        - `id` integer
        - `name` string
        - `description` string
  - `total` integer
  - `count` integer
  - `perPage` integer
  - `currentPage` integer
  - `totalPages` integer

## Other responses

- `400`: Request is malformed or invalid.
- `404`: Resource not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)