Get Group Provider Info

GET/api/v2/admin/groups/{groupId}/providerInfo

Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Get the GroupProviderInfo.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:admin-read.

Path parameters

groupId

string

The ID of a Foundry Group or User.

Query parameters

preview

boolean

optional

Enables the use of preview functionality.

Response body

GroupProviderInfo

object

Hide child attributes

providerId

string

The ID of the Group in the external authentication provider. This value is determined by the authentication provider. At most one Group can have a given provider ID in a given Realm.

Examples

Request

Copied!

curl \
	-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/admin/groups/f05f8da4-b84c-4fca-9c77-8af0b13d11de/providerInfo?preview=true"

Response

Copied!

{
  "providerId": "2838c8f3-d76a-4e99-acf1-1dee537e4c48"
}

Error responses

Error Name
`GroupProviderInfoNotFound`	Error Code	`NOT_FOUND`
	Status Code	404
	Description	The given GroupProviderInfo could not be found.
	Parameters	`groupId`

See Errors for a general overview of errors in the platform.