Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Get User Provider Info

GET/api/v2/admin/users/{userId}/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 UserProviderInfo.

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

Path parameters

userId
string

The ID of a Foundry Group or User.

Query parameters

preview
boolean
optional

Enables the use of preview functionality.

Response body

UserProviderInfo
object
Hide child attributes

Hide child attributes

providerId
string

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

Examples

Request

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

Response

Copied!
1 2 3 { "providerId": "2838c8f3-d76a-4e99-acf1-1dee537e4c48" }

Error responses

Error Name
UserProviderInfoNotFoundError CodeNOT_FOUND
Status Code404
DescriptionThe given UserProviderInfo could not be found.
ParametersuserId