Add a family member

POST

https://uat-api.hastaai.in/api/v1/users/family

user

Last modified:2026-08-13 18:45:26

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. intent (optional) is a JSON array string of intent slugs for this member (e.g. '["career", "wealth"]', max 3 kept) - fetch valid slugs from GET /lookup/intents; to change them later use PATCH /users/family/{family_key}/intents instead of re-adding the member. 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. Also returns 200 with success: false and code: PLAN_LIMIT (not an HTTP error) when header X-Enforce-Paywall: true is sent and the family list has hit the plan's family_add limit

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat-api.hastaai.in/api/v1/users/family' \
--header 'Authorization: Bearer <token>' \
--form 'full_name=""' \
--form 'relation_name=""' \
--form 'date_of_birth=""' \
--form 'birth_time=""' \
--form 'moon_sign=""' \
--form 'intent=""' \
--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-08-13 18:45:26

Get my family members

Delete a family member