Get a connection

GET /v1/connections/{connection_id} · permission connections:read

Returns one connection. The ETag response header carries the version to send as If-Match on PATCH and DELETE.

For an enterprise connection the response also has pending_revision_id: the ID of the connection's pending draft revision (connrev_…), or null when there is none. The field appears only on this endpoint, and is left out if the enterprise configuration service cannot be read at that moment.

Request

Field	Type	Required	Description
`connection_id`	string	yes	Connection identifier (`conn_…`).

Response

200 OK with the connection.

{
  "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
  "key": "google",
  "type": "social",
  "strategy": "google",
  "name": "Google",
  "display_name": "Sign in with Google",
  "status": "inactive",
  "org_id": null,
  "allowed_email_domains": [],
  "allow_external_domains": false,
  "jit_mode": null,
  "email_trust": null,
  "default_role_ids": [],
  "trust_idp_mfa": null,
  "allow_idp_initiated": null,
  "idp_initiated_default_application_id": null,
  "idp_initiated_allowed_application_ids": [],
  "settings": {},
  "created_at": "2026-10-05T09:30:00.123456Z",
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Errors

HTTP	code	When
404	`not_found`	The connection does not exist or belongs to another environment.
401	`unauthenticated`	The credential is missing, invalid or revoked.
403	`insufficient_permissions`	The credential lacks the required permission.
429	`rate_limited`	The rate limit was exceeded; retry after the `Retry-After` period.
503	`service_unavailable`	A dependency is temporarily unavailable; retry after the `Retry-After` period.

Example

curl https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"