PATCH
/
users
/
{userID}
/
identifiers
/
{identifierID}
Update a login identifier for a user
curl --request PATCH \
  --url https://backendapi.corbado.io/v2/users/{userID}/identifiers/{identifierID} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "pending"
}'
{
  "identifierID": "ide-4693224802260150919",
  "type": "email",
  "value": "jane@doe.com",
  "status": "pending",
  "userID": "usr-4693224802260150919"
}

Authorizations

Authorization
string
header
required

Basic authentication is used to authenticate requests to the Backend API. The username is the project ID and the password is the API secret.

The project ID and API secret can be found in the Developer Panel.

Path Parameters

userID
string
required

Unique identifier of the user. Format: usr-<number>.

Example:

"usr-4693224802260150919"

identifierID
string
required

Unique identifier of the login identifier (e.g., email address or phone number). Format: ide-<number>.

Example:

"ide-4693224802260150919"

Body

application/json
status
enum<string>
required
Available options:
pending,
primary,
verified

Response

Identifier has been updated.

identifierID
string
required

Unique identifier of the login identifier.

Example:

"ide-4693224802260150919"

type
enum<string>
required
Available options:
email,
phone,
username
value
string
required

Value of the identifier (here email address).

Example:

"jane@doe.com"

status
enum<string>
required
Available options:
pending,
primary,
verified
userID
string
required

Unique identifier of the user.

Example:

"usr-4693224802260150919"