Add or update username
Assigns or updates the username for the user, enabling username-based authentication when applicable.
API-KeyX-API-KEY<token>MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>
The unique identifier of the user.
Request Body
application/json
The request payload used to add or update the username.
TypeScript Definitions
Use the request body type in TypeScript.
Update Username Request: Used to add a new username or update the existing one for a user account.
Response Body
application/json
The username was successfully assigned
TypeScript Definitions
Use the response body type in TypeScript.
User: Represents a user account returned by the operation.
Errors
curl -X PUT "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/username" \ -H "X-API-KEY: <token>" \ -H "Content-Type: application/json" \ -d '{ "username": "string" }'{ "user_id": "string", "disabled": true, "claims": { "property1": null, "property2": null }, "public_data": { "property1": null, "property2": null }, "private_data": { "property1": null, "property2": null }, "emails": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "primary": true, "verified": true, "source": null, "verification_source": null, "email": "string" } ], "phone_numbers": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "primary": true, "verified": true, "source": null, "verification_source": null, "phone": "string" } ], "passkeys": [ { "name": null, "passkey_id": "string", "public_key": "string", "aa_guid": "8a066881-0124-4a97-b518-fe03ecf6e108", "backup_state": true, "backup_eligibility": true, "user_present": true, "user_verified": true, "user_agent": "string" } ], "force_password_reset": true, "external_providers": [ { "provider": "string", "authenticator": "google", "provider_user_id": "string", "claims": { "property1": null, "property2": null } } ], "creation_time": 0, "last_updated": 0, "username": null, "has_password": true, "password_updated_at": null, "block_until": null, "failure_count": 0, "sign_in_attempts_count": 0, "last_sign_in_attempt": null, "last_sign_in_attempt_ip": null, "sign_in_success_count": 0, "last_sign_in_success": null, "last_sign_in_success_ip": null, "last_activity": null, "last_known_city": null, "last_known_country": null, "last_known_region": null}Remove a username DELETE
Removes the username from the user's account. Once removed, the user will no longer be able to authenticate using a username.
Add an email address POST
Adds a new email address to the user profile. Optional parameters allow specifying whether the email should be marked as verified.