List SAML Linked Members
The members of your active account linked to their identity at the IdP of a saml SSO config. A member's first SAML sign-in links them to the Name ID the IdP sends; later sign-ins must carry the same one. The Name ID itself is never shown.
Requires the settings:read account permission. Account keys can't use it.
Path parameters
uuid string (uuid) Req
An integer id in the path is refused with 400 integer_id_unsupported (see public IDs). Use the uuid.
Response (200 OK)
links: the linked members, the newest link first (up to 1,000). Each:
user_uuid string (uuid)
The member. A person resets their link in the dashboard.
email string
The member's email at ngris.
linked_at datetime
Their first SAML sign-in through this config.
last_sign_in_at datetime
Their latest SAML sign-in through it.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
No active account, the caller lacks
settings:read, or an account key.404 Not Found
“SSO configuration not found” (it doesn't exist or isn't your active account's), or “This SSO configuration is not a SAML one.”
Request
curl "https://api.ngris.com/v1/sso/config/019af662-7814-75fe-ac3c-b767d84325a9/saml-links" \
-H "X-API-KEY: <your_api_key>"
CLI
ngris api sso-configs saml-links 019af662-7814-75fe-ac3c-b767d84325a9
Response — 200 OK
{
"links": [
{
"user_uuid": "019a68b9-1a79-7820-a884-41f554aba6bd",
"email": "amy@acme.com",
"linked_at": "2026-11-20T09:12:00Z",
"last_sign_in_at": "2026-11-20T15:40:00Z"
}
]
}
Was this helpful?