In this article
Get Group
Gets a specific group.
URL
https://{{HOST}}/security/group?groupId={groupId}&v={version}
Method
GET
Required IMS Scopes
- securityapi_all
Versions Supported
- 2.0 (Default)
URL Query Parameters
| Name | Description | Example | Type |
|---|---|---|---|
| v optional |
Version of the api to use | /group?v=2.0 | number |
| groupId required |
The ID of the group. | /group?groupId=testGroup | string |
Request Header Parameters
| Type | Value | Description |
|---|---|---|
| Authorization required |
Bearer {access_token} | IMS access token |
Example
Request
curl -X GET
'https://{{HOST}}/security/group?groupid=testGroup&v=2.0'
-H 'Authorization: Bearer {access_token}'
Response
{
"id":"testGroup",
"subject":"null"
}
Errors
| Error | Description |
|---|---|
| Error Name | Description of Error |
Response Body Parameters
| Name | Description | Schema |
|---|---|---|
| id | Description | object definition |
| subject | Description | object definition |