Add a family member

POST

/api/v1/users/family

user

Last modified:2026-06-04 22:55:16

Request: multipart/form-data

Add a family member with a relation name and optional birth details. relation_name must match a valid relation from the /lookup endpoint. Optionally upload a profile photo (JPEG / PNG / WebP, max 5 MB). Requires a valid Bearer token.

Success: 200 - returns { success, message } only (no data). Re-fetch the updated list via GET /users/family.

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 '/api/v1/users/family' \
--form 'full_name=""' \
--form 'relation_name=""' \
--form 'date_of_birth=""' \
--form 'birth_time=""' \
--form 'birth_place=""' \
--form 'latitude=""' \
--form 'longitude=""' \
--form 'timezone=""' \
--form 'gender=""' \
--form 'profile_image=""'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Family member added."
}

🟠401Unauthorized

🟠422Parameter Error

Modified at 2026-06-04 22:55:16

Get my family members

Delete a family member