Skip to content

Upload user file

POST
/api/v1/user/{id}/file
curl --request POST \
--url https://example.com/api/v1/user/example/file \
--header 'Content-Type: multipart/form-data' \
--form file=@file

Uploads a file (avatar) for a user

id
required
string
Media type multipart/form-data
object
file
string format: binary

File uploaded, user updated

Media type application/json
object
id
required

User ID (15 chars)

string
username
required

Username (3+ chars, alphanumeric with dots)

string
email
required

User email address

string format: email
avatar

Avatar file path

string
verified

Email verification status

boolean
created
string format: date-time
updated
string format: date-time
Example generated
{
"id": "example",
"username": "example",
"email": "hello@example.com",
"avatar": "example",
"verified": true,
"created": "2026-04-15T12:00:00Z",
"updated": "2026-04-15T12:00:00Z"
}

Bad Request

Not Found

Internal Server Error