Skip to content
Purser

Unlink User Oidc

DELETE
/users/{user_id}/oidc
curl --request DELETE \
  --url https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/oidc

Remove a user’s SSO link (admin scope; audited as user.unlink_oidc).

A linked account refuses a different subject from the same provider, so this is how an administrator lets someone sign in with a new identity at that provider. The account and its password, if any, are kept; the next SSO sign-in that asserts the account’s verified email links it again. 404 for an unknown user, 409 when the user has no SSO link.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
user_id
required
User Id
string format: uuid

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
UserOut
object
created_at
required
Created At
string format: date-time
display_name
required
Any of:
string
email
required
Email
string
has_oidc
required
Has Oidc
boolean
has_password
required
Has Password
boolean
id
required
Id
string format: uuid
oidc_issuer
Any of:
string
role
required
Role
string

Example generated

{
  "created_at": "2026-04-15T12:00:00Z",
  "display_name": "example",
  "email": "example",
  "has_oidc": true,
  "has_password": true,
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "oidc_issuer": "example",
  "role": "example"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string

Example generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}