Get user

Retrieve the profile of the specified user.

get
https://api.insomnia.rest/v3/users/{userId}

Path Parameters

userIdstringrequired

The user ID

Example:usr_abc123

Response

application/json

A single user profile response

User

The user’s full profile

idstringrequiredread-only

Unique identifier for the user

Example:usr_abc123

first_namestringrequired

The user’s first name

Example:Jane

last_namestringrequired

The user’s last name

Example:Doe

picturestring(uri)

URL to the user’s profile picture

Example:https://cdn.insomnia.rest/avatars/usr_abc123.jpg

emailstring(email)required

The email address

Example:jane.doe@example.com

emailsarray[object]requiredread-only

An email address associated with a user

Show Child Parameters
is_externally_provisionedbooleanrequiredread-only

Indicates the user was provisioned externally (e.g., via SCIM). When true, profile fields (first_name, last_name, email, emails, picture) cannot be updated by the user.

Example:false

encryption_enabledbooleanrequiredread-only

Whether end-to-end encryption is enabled for this user

Example:false

created_atstring(date-time)requiredread-only

The date and time the user account was created

Example:2024-01-15T08:30:00Z

get/users/{userId}
 
application/json

Update current user

Update the profile of the currently authenticated user.
All fields are optional - only provided fields will be updated.

patch
https://api.insomnia.rest/v3/users/me

Body

application/json

UserUpdate

Fields that can be updated on a user profile

first_namestring

The user’s first name

Example:Jane

last_namestring

The user’s last name

Example:Doe

Response

application/json

A single user profile response

User

The user’s full profile

idstringrequiredread-only

Unique identifier for the user

Example:usr_abc123

first_namestringrequired

The user’s first name

Example:Jane

last_namestringrequired

The user’s last name

Example:Doe

picturestring(uri)

URL to the user’s profile picture

Example:https://cdn.insomnia.rest/avatars/usr_abc123.jpg

emailstring(email)required

The email address

Example:jane.doe@example.com

emailsarray[object]requiredread-only

An email address associated with a user

Show Child Parameters
is_externally_provisionedbooleanrequiredread-only

Indicates the user was provisioned externally (e.g., via SCIM). When true, profile fields (first_name, last_name, email, emails, picture) cannot be updated by the user.

Example:false

encryption_enabledbooleanrequiredread-only

Whether end-to-end encryption is enabled for this user

Example:false

created_atstring(date-time)requiredread-only

The date and time the user account was created

Example:2024-01-15T08:30:00Z

patch/users/me

Body

{}
 
application/json

Start adding a user email address

Sends a verification code to the email address provided (if available).

post
https://api.insomnia.rest/v3/users/me/emails

Body

application/json

Request to send a verification code to a user email address

emailstring(email)required

The email address

Example:jane.doe@example.com

Response

application/json

Verification code sent successfully response

* Additional properties are NOT allowed.
emailstring(email)required

The email address

Example:jane.doe@example.com

post/users/me/emails

Body

{ "email": "jane.doe@example.com" }
 
application/json

Verify an email address

Verify an email address for the current user.

put
https://api.insomnia.rest/v3/users/me/emails/{address}/verify

Path Parameters

addressstring(email)required

The email address

Example:jane.doe@example.com

Body

application/json

Request to verify a user email address

codestringrequired

Example:1W34Q6

Response

Email verified successfully

put/users/me/emails/{address}/verify

Body

{ "code": "1W34Q6" }
 

Set the primary email address

Set the primary email address for the current user.

put
https://api.insomnia.rest/v3/users/me/emails/{address}/primary

Path Parameters

addressstring(email)required

The email address

Example:jane.doe@example.com

Response

application/json

Email set as primary successfully

UserEmail

An email address associated with a user

emailstring(email)required

The email address

Example:jane.doe@example.com

is_primarybooleanrequired

Whether this is the user’s primary email

Example:true

put/users/me/emails/{address}/primary
 
application/json