---
title: "POST /Groups"
method: POST
path: "/Groups"
---

# POST /Groups

`POST /Groups`

Retrieves all active group details.

## Query parameters

- `NextToken` string

## Request body

- object
  - `NextToken` string — Pagination token.

## Response `200`

Success

- GetGroupsResult
  - `Groups` GroupSummary[] — The collection of all active groups.
    - `GroupName` string — The unique case-sensitive name of the group.
    - `GroupARN` string — The ARN of the group generated based on the GroupName.
    - `FilterExpression` string — The filter expression defining the parameters to include traces.
    - `InsightsConfiguration` object — <p>The structure containing configurations related to insights.</p> <ul> <li> <p>The InsightsEnabled boolean can be set to true to enable insights for the group or false to disable insights for the group.</p> </li> <li> <p>The NotificationsEnabled boolean can be set to true to enable insights notifications. Notifications can only be enabled on a group with InsightsEnabled set to true.</p> </li> </ul>
      - `InsightsEnabled` boolean — Set the InsightsEnabled value to true to enable insights or false to disable insights.
      - `NotificationsEnabled` boolean — Set the NotificationsEnabled value to true to enable insights notifications. Notifications can only be enabled on a group with InsightsEnabled set to true.
  - `NextToken` string — Pagination token.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottledException

---

[API](https://skmtc.net/aws/apis/xray.md) · [All operations](https://skmtc.net/aws/apis/xray/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/xray/versions/4970909a360e/schema)