Create / complete user profile

PUT

/api/v1/users/profile

user

Last modified:2026-05-26 17:02:01

Request: multipart/form-data

Save birth details and gender. Optionally upload a profile photo (JPEG / PNG / WebP, max 5 MB). Current location is resolved from the request IP automatically. Marks the user as onboarded on first call. Re-submitting updates the profile. Requires a valid Bearer token.

Success: 200

Errors: 401 - missing/invalid token | 422 - validation error or invalid image

Request

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/api/v1/users/profile' \
--form 'full_name=""' \
--form 'date_of_birth=""' \
--form 'birth_time=""' \
--form 'birth_place=""' \
--form 'city=""' \
--form 'state=""' \
--form 'country=""' \
--form 'latitude=""' \
--form 'longitude=""' \
--form 'timezone=""' \
--form 'gender=""' \
--form 'profile_image=""'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Profile saved successfully"
}

🟠401Unauthorized

🟠422Parameter Error

Modified at 2026-05-26 17:02:01

Admin - delete user and all family members

Admin - update user status