>>

Edit Profile

This route requires a valid Authorization header.

PATCH/users/profile

Modify your profile.

>>

Request Body
FieldTypeDescription
display_name?String?The user’s new display name. This field has to be between 2 and 32 characters long.
status?String?The user’s new status. This field cannot be more than 150 characters long.
status_type?StatusTypeThe user’s new status type. This must be one of ONLINE, OFFLINE, IDLE and BUSY.
bio?String?The user’s new bio. The upper limit is the instance’s Instance Info bio_limit.
avatar?Number?The user’s new avatar. This field has to be a valid file ID in the “avatars” bucket.
banner?Number?The user’s new banner. This field has to be a valid file ID in the “banners” bucket.
>>

Response

200User

FieldTypeDescription
idNumberThe user’s ID.
usernameStringThe user’s username. This field has to be between 2 and 32 characters long.
display_name?StringThe user’s display name. This field has to be between 2 and 32 characters long.
social_creditNumberThe user’s social credit score.
statusStatusThe user’s status.
bio?StringThe user’s bio. The upper limit is the instance’s Instance Info bio_limit.
avatar?NumberThe user’s avatar. This field has to be a valid file ID in the “avatar” bucket.
banner?NumberThe user’s banner. This field has to be a valid file ID in the “banner” bucket.
badgesNumberThe user’s badges as a bitfield.
permissionsNumberThe user’s instance-wide permissions as a bitfield.
email?StringThe user’s email. This is only shown when the user queries their own data.
verified?BooleanThe user’s verification status. This is only shown when the user queries their own data.
>>

Example

 
curl \
  -H "Authorization: <token>" \
  -X PATCH
  --json '{"display_name":"HappyRu","bio":"I am very happy!"}'
  https://api.eludris.gay/users/profile

{
  "id": 2346806935553,
  "username": "yendri",
  "display_name": "HappyRu",
  "social_credit": 0,
  "bio": "I am very happy!",
  "badges": 0,
  "permissions": 0
}