---
title: "POST /accounts/{AwsAccountId}/namespaces/{Namespace}/groups-search"
method: POST
path: "/accounts/{AwsAccountId}/namespaces/{Namespace}/groups-search"
---

# POST /accounts/{AwsAccountId}/namespaces/{Namespace}/groups-search

`POST /accounts/{AwsAccountId}/namespaces/{Namespace}/groups-search`

Use the <code>SearchGroups</code> operation to search groups in a specified Amazon QuickSight namespace using the supplied filters.

## Path parameters

- `AwsAccountId` string, required
- `Namespace` string, required

## Query parameters

- `next-token` string
- `max-results` integer

## Request body

- object
  - `Filters` GroupSearchFilter[], required — The structure for the search filters that you want to apply to your search.
    - `Operator` 'StartsWith', required — The comparison operator that you want to use as a filter, for example <code>"Operator": "StartsWith"</code>. Currently, the only supported operator is <code>StartsWith</code>.
    - `Name` 'GROUP_NAME', required — The name of the value that you want to use as a filter, for example <code>"Name": "GROUP_NAME"</code>. Currently, the only supported name is <code>GROUP_NAME</code>.
    - `Value` string, required — The value of the named item, in this case <code>GROUP_NAME</code>, that you want to use as a filter.

## Response `200`

Success

- SearchGroupsResponse
  - `GroupList` Group[] — A list of groups in a specified namespace that match the filters you set in your <code>SearchGroups</code> request.
    - `Arn` string — The Amazon Resource Name (ARN) for the group.
    - `GroupName` string — The name of the group.
    - `Description` string — The group description.
    - `PrincipalId` string — The principal ID of the group.
  - `NextToken` string — A pagination token that can be used in a subsequent request.
  - `RequestId` string — The Amazon Web Services request ID for this operation.
  - `Status` integer — The HTTP status of the request.

## Other responses

- `480` — AccessDeniedException
- `481` — InvalidParameterValueException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InvalidNextTokenException
- `485` — PreconditionNotMetException
- `486` — InternalFailureException
- `487` — ResourceUnavailableException

---

[API](https://skmtc.net/aws/apis/quicksight.md) · [All operations](https://skmtc.net/aws/apis/quicksight/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/quicksight/revisions/2f2bbd7e70ca/schema)