Skip to main content
GET
/
connections
/
{nameOrID}
/
federation
/
oauth
Report the user's per-user federation connection status
curl --request GET \
  --url https://use.hoop.dev/api/connections/{nameOrID}/federation/oauth
{
  "connected": false,
  "google_email": "alice@example.com",
  "provider": "gcp_oauth"
}

Path Parameters

​
nameOrID
string
required

Name or UUID of the connection

Response

OK

​
connected
boolean

Connected is true when the user has a stored credential for this connection. Always false for providers that are not per-user.

Example:

false

​
google_email
string

GoogleEmail is the consented Google identity, present only when Connected is true for gcp_oauth.

Example:

"alice@example.com"

​
provider
string

Provider is the connection's configured federation provider (e.g. "gcp_oauth", "gcp_iam"), or empty when the connection has no federation configured. Only gcp_oauth requires a per-user connection.

Example:

"gcp_oauth"