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

# POST /GetGroup

`POST /GetGroup`

Retrieves group resource details.

## Request body

- object
  - `GroupName` string — The case-sensitive name of the group.
  - `GroupARN` string — The ARN of the group that was generated on creation.

## Response `200`

Success

- GetGroupResult
  - `Group` object — The group that was requested. Contains the name of the group, the ARN of the group, the filter expression, and the insight configuration assigned to the group.
    - `GroupName` string — The unique case-sensitive name of the group.
    - `GroupARN` string — The Amazon Resource Name (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 through Amazon EventBridge for the group.</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.

## 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)