Reset a SAML Link
Reset a member's link in a saml SSO config of your active account: their next SAML sign-in links them to the Name ID the IdP sends then. Use it when the IdP sends another Name ID for a linked member, for example after their address moved to another person or their IdP account was recreated: until the reset, their sign-in is refused.
A person's act. The link is what keeps a reassigned address out of the previous person's user, so resetting it changes who can sign in as the member. Only a signed-in dashboard session may do it (API keys, account keys, OAuth/MCP tokens and the AI assistant get 403 interactive_session_required), with the caller's password in a JSON body (and mfa_code when two-factor is on). In the dashboard: Single Sign-On → Linked members → Reset link.
The member keeps their account, roles and sessions. Requires the settings:update account permission.
Path parameters
user_uuid, from the linked members.An integer id in the path is refused with 400 integer_id_unsupported (see public IDs). Use the uuid.
Request body
Response (204 No Content)
Empty body on success.
Errors
code tells what's missing: reauth_required (send password), invalid_password, mfa_required (send mfa_code) or invalid_mfa.settings:update, or interactive_session_required: an API key, account key, OAuth/MCP token or the AI assistant.