Update current user

PATCH

Updates the currently authenticated user. Only the values provided will be updated.

Request

This endpoint expects an object.

display_namestringOptional

Human-readable user display name. This is not a unique identifier.

profile_image_urlstringOptional

URL of the profile image for user. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.

client_metadatamap from strings to anyOptional

Client metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client.

selected_team_idstringOptional

ID of the team currently selected by the user

totp_secret_base64stringOptional

Enables 2FA and sets a TOTP secret for the user. Set to null to disable 2FA.

Response

Successful response

idstring

The unique identifier of the user

primary_email_verifiedboolean

Whether the primary email has been verified to belong to this user

signed_up_at_millisdouble

The time the user signed up identify=>(the number of milliseconds since epoch, January 1, 1970, UTC)

selected_teamobjectOptional

primary_emailstringOptional

Primary email

display_namestringOptional

Human-readable user display name. This is not a unique identifier.

client_metadatamap from strings to anyOptional

Client metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client.

client_read_only_metadatamap from strings to anyOptional

Client read-only, server-writable metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client. The client can read this data, but cannot modify it. This is useful for things like subscription status.

profile_image_urlstringOptional

URL of the profile image for user. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.

selected_team_idstringOptional

ID of the team currently selected by the user

PATCH

1 curl -X PATCH https://api.stack-auth.com/api/v1/users/me \
2      -H "Content-Type: application/json" \
3      -d '{
4   "display_name": "John Doe",
5   "profile_image_url": "https://example.com/image.jpg",
6   "client_metadata": {
7     "key": "value"
8   },
9   "selected_team_id": "team-id",
10   "totp_secret_base64": "dG90cC1zZWNyZXQ="
11 }'

200Updated

1 {
2   "id": "3241a285-8329-4d69-8f3d-316e08cf140c",
3   "primary_email_verified": true,
4   "signed_up_at_millis": 1630000000000,
5   "selected_team": {
6     "id": "ad962777-8244-496a-b6a2-e0c6a449c79e",
7     "display_name": "My Team",
8     "profile_image_url": "https://example.com/image.jpg",
9     "client_metadata": {
10       "key": "value"
11     },
12     "client_read_only_metadata": {
13       "key": "value"
14     }
15   },
16   "primary_email": "johndoe@example.com",
17   "display_name": "John Doe",
18   "client_metadata": {
19     "key": "value"
20   },
21   "client_read_only_metadata": {
22     "key": "value"
23   },
24   "profile_image_url": "https://example.com/image.jpg",
25   "selected_team_id": "team-id"
26 }