REST API endpoints for Users

Get a user

GET /users/{userId}

Authentication

Authentication may enable this endpoint return more information.

Authenticated user can retrieve private information when the target user is the current authenticated user and has user:read scope.

Learn more about authentication

Path Parameters

userIdstringRequired

The id or username of the user to retrieve.
Can be also @me for the current authenticated user.

Response Body Content-Type: application/json

This API endpoint returns standard API response format. The following fields are fields of the data object. Learn more

idstringRequired

The unique identifier of the user.

namestringRequired

The display name of the user.

usernamestringRequired

The username of the user.

created_atstringRequired

ISO 8601 timestamp of when the user was created.

rolestringRequired

The role of the user. Can be user, moderator or admin.

avatar_urlstring

The URL of the user avatar.

biostring

The short bio of the user.

Modify a user

PATCH /users/{userId}

Can only update the current authenticated user.

Authentication

Authentication is required.

Access token must have user:update scope.

Learn more about authentication

Path Parameters

userIdstringRequired

The id or username of the user to retrieve.
Can be also @me for the current authenticated user.

Request Body Content-Type: application/json

Only the provided fields will be updated. To remove an optional field, set it to null.

namestring

The display name of the user. Regex: /^[p{L}p{N} _-]+$/u

biostring

The short bio of the user.

Response Body Content-Type: application/json

This API endpoint returns standard API response format. The following fields are fields of the data object. Learn more

idstringRequired

The unique identifier of the user.

namestringRequired

The display name of the user.

usernamestringRequired

The username of the user.

created_atstringRequired

ISO 8601 timestamp of when the user was created.

rolestringRequired

The role of the user. Can be user, moderator or admin.

avatar_urlstring

The URL of the user avatar.

biostring

The short bio of the user.