Change your name

POST

/api/auth/update-user

curl --request POST \
  --url http://localhost:3000/api/auth/update-user \
  --header 'Content-Type: application/json' \
  --cookie merran.session_token=<merran.session_token> \
  --data '{ "name": "Sam R." }'

• Your Merran

Your name, username or picture.

Authorizations

• session

Request Body

Media typeapplication/json

object

name

The name of the user

string

image

The image of the user

string

nullable

username

string

displayUsername

string

Example

{
  "name": "Sam R."
}

Responses

200

Success

Media typeapplication/json

object

user

object

id

required

string

name

required

string

email

required

string

emailVerified

required

boolean

image

string

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

username

string

displayUsername

string

role

string

banned

boolean

banReason

string

banExpires

string format: date-time

Example

{
  "user": {
    "id": "0199e8b0-5a10-7a01-8b00-000000000001",
    "name": "Sam R.",
    "email": "sam@example.com",
    "emailVerified": false,
    "image": null,
    "createdAt": "2026-10-01T17:30:00.000Z",
    "updatedAt": "2026-10-01T17:30:00.000Z",
    "username": "sam",
    "displayUsername": "sam",
    "role": "admin",
    "banned": false
  }
}

400

Bad Request. Usually due to missing parameters, or invalid parameters.

Media typeapplication/json

object

message

required

string

Example ^generated

{
  "message": "example"
}

401

Unauthorized. Due to missing or invalid authentication.

Media typeapplication/json

object

message

required

string

Example ^generated

{
  "message": "example"
}

403

Forbidden. You do not have permission to access this resource or to perform this action.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}

404

Not Found. The requested resource was not found.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}

429

Too Many Requests. You have exceeded the rate limit. Try again later.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}

500

Internal Server Error. This is a problem with the server that you cannot fix.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}