Users / Profile

Upload business card photo

POST/users/me/card-photo

Upload a photo to use as the business card background as multipart/form-data (field name cardPhoto) and get the stored URL. The photo is auto-oriented, scaled down to 1600px on its longer side and converted to WebP. This call does not change the profile; pass the returned URL as cardPhoto.url to PUT /users/me to save it.

AuthLogin required

Request body

cardPhotofilerequired

Image file (multipart/form-data)

Notes

Images are sent as multipart/form-data. JPEG, PNG and GIF are supported, up to 5MB. Exceeding the limit returns 400 (errorCode 10042).

Response

FieldTypeDescription
cardPhotoUrlstringURL of the uploaded photo.
Request
curl https://api.4s.link/users/me/card-photo \
-X POST \
-H "Authorization: Bearer 4s_at_..." \
-F "file=@image.png"
Example response
{
"cardPhotoUrl": "https://.../users/a1b2c3d4-.../card-photo/1759500000000-abc123.webp"
}