Sign in

v5

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-0330110112.1 KB
Groups

Get one Group

Get a Group using HRID

get/organizations/{orgId}/environments/{envId}/groups/{hrid}

Path parameters

orgIdstring required
Example:dedd0e0f-b3e9-4d2f-89cd-b2a9de7cb145

organization ID

envIdstring required
Example:a44e0d1b-9fa9-4d64-8b76-3634623a2e27

environment ID

hridstring required
Example:my_demo_api

Human-readable ID of a spec

Query parameters

hridContainsUUIDboolean

When true, the HRID path or spec value is treated as an existing UUID rather than a human-readable identifier. This is to support backward compatibility for resources created before migration to the automation API and should not be used for new resources.

Response

Group successfully retrieved

hridstring required

A unique human readable id identifying this resource

namestring required

Group's name.

notifyMembersboolean

If true, members will be notified when the group is synced with APIM.

idstring

Resource UUID.

environmentIdstring

The environment ID.

organizationIdstring

The organization ID.

memberCountinteger

Number of members in the group.

Example response

{
  "hrid": "demo_api",
  "name": "developers",
  "members": [
    {
      "source": "gravitee",
      "sourceId": "john.doe@acme.com",
      "roles": {
        "API": "USER",
        "APPLICATION": "ADMIN",
        "INTEGRATION": "ACME_READ_ONLY"
      }
    }
  ],
  "memberCount": 5
}