Delete passkey

The endpoint provides functionality to delete a passkey for an existing user.

HTTP request

DELETE https://$instanceId.id.nevis.cloud/nevis/api/v1/users/$userId/passkeys/$passkeyId

Parameters

Parameter	In	Type	Required / Optional	Description
instanceId	path	string	required	The ID of your Identity Cloud instance
userId	path	string	required	The ID of the user
passkeyId	path	string	required	The ID of the passkey

Example request

Set the ID of the user and passkey.

userId=your-user-id-123
passkeyId=your-passkey-id-123

curl --request DELETE "https://$instanceId.id.nevis.cloud/nevis/api/v1/users/$userId/passkeys/$passkeyId" \
  --header "Authorization: Bearer $accessKey"

HTTP response

On success

HTTP/1.1 204 is returned on success.

On missing credential

HTTP/1.1 404 is returned if no user is found with the given userId or no passkey is found with the given passkeyId.

User is not found

{
    "error": "User with id: 3eb1c041-c76b-4ae8-8307-db29b97d516a cannot be found."
}

Passkey is not found

{
    "error": "Passkey with id: 9bbae207-f1ff-4174-a7fc-e771a46f3ce0 cannot be found."
}

On failure

HTTP/1.1 401 is returned if the authorization fails due to an invalid access key.

HTTP/1.1 500 is returned if an unexpected error occurs.