v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_User

Update user profile

Updates the authenticated user's own profile details.

Use this endpoint when the currently authenticated user needs to update their own display name. This endpoint is scoped to self-service profile edits only and cannot be used to modify another user's account or change role and group assignments.

About Update User Profile

This endpoint allows a user to update their own profile via the authn2 identity service. The request body accepts only first_name — role changes, group reassignments, and other administrative updates must be performed by an Enterprise Admin via PUT /authz2/v1/users/{user_id}. The user_id parameter expects the UUID-format authn_user_id, not the integer id from GET /user/.

Key Fields / Request Body

first_name — (required) the updated first name for the authenticated user

Common Use Cases

Allowing a user to correct or update their display name after account creation

Best Practices

Use GET /user_info/ to confirm the current user's authn_user_id before calling this endpoint

For role or group changes, use PUT /authz2/v1/users/{user_id} — this endpoint cannot modify access permissions

Workflow

Call GET /user_info/ to retrieve the authenticated user's authn_user_id

PUT to this endpoint with the updated first_name

Confirm the change in the returned User object

put/authn2/v0/user/{user_id}

Path parameters

enterprise_idstring uuid required

Enterprise ID

user_idstring uuid required

AuthN User Id. The authn_user_id from the Get Users response.

Request body

first_namestring required

Response

User Updated Successfully

idinteger
usernamestring
emailstring email
first_namestring
last_namestring
full_namestring
is_staffboolean
is_superuserboolean
is_activeboolean
last_loginstring
tokenstring
has_emmboolean
is_email_verifiedboolean