Lists all AppGroups in an organization. A maximum of 1000 AppGroups are returned in the response if PageSize is not specified, or if the PageSize is greater than 1000.
HTTP request
GET https://apigee.googleapis.com/v1/{parent=organizations/*}/appgroups
Required. Name of the Apigee organization. Use the following structure in your request:organizations/{org}.
Authorization requires the followingIAMpermission on the specified resourceparent:
apigee.appgroups.list
Query parameters
Parameters
filter
string
The filter expression to be used to get the list of AppGroups, where filtering can be done on status, channelId or channelUri of the app group. Examples: filter=status=active", filter=channelId=, filter=channelUri=
pageSize
integer
Count of AppGroups a single page can have in the response. If unspecified, at most 1000 AppGroups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
The starting index record for listing the AppGroups.
Request body
The request body must be empty.
Response body
ListAppGroupsResponse contains the 0 or more AppGroups, along with the optional page token and the total count of apps.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of AppGroups within a specified Apigee organization, supporting pagination and filtering capabilities.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires the organization's name as a path parameter (\u003ccode\u003eparent\u003c/code\u003e), formatted as \u003ccode\u003eorganizations/{org}\u003c/code\u003e, and authorization requires the \u003ccode\u003eapigee.appgroups.list\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter AppGroups by status, channelId, or channelUri using the \u003ccode\u003efilter\u003c/code\u003e query parameter, and use \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for paginated results, with a maximum of 1000 AppGroups per page.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, while the successful response body is a JSON object that includes a list of \u003ccode\u003eappGroups\u003c/code\u003e, the total number of \u003ccode\u003eappGroups\u003c/code\u003e, and an optional \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this endpoint requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.appgroups.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAppGroupsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all AppGroups in an organization. A maximum of 1000 AppGroups are returned in the response if PageSize is not specified, or if the PageSize is greater than 1000.\n\n### HTTP request\n\n`GET https://apigee.googleapis.com/v1/{parent=organizations/*}/appgroups`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nListAppGroupsResponse contains the 0 or more AppGroups, along with the optional page token and the total count of apps.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`"]]
