Home > Documentation

Update a person's age

Table of contents

This endpoint lets you update the age information of a person.

You can set an exact age (with birth date), an estimated age, or an age bracket. When setting an exact age, you can optionally add a yearly reminder for the person's birthday.

Update a person's age

This endpoint updates the age information of a person. It will return the updated person in the response.

URL parameters

person integer required

The ID of the person.

Query parameters

age_type string required

Type of age information. Must be one of: 'exact', 'estimated', or 'bracket'.

age_year integer

Required when age_type is 'exact'. The birth year.

age_month integer

Optional when age_type is 'exact'. The birth month (1-12).

age_day integer

Optional when age_type is 'exact'. The birth day (1-31).

estimated_age integer

Required when age_type is 'estimated'. The estimated age in years.

age_bracket string

Required when age_type is 'bracket'. The age bracket (e.g., '18-25').

add_yearly_reminder boolean required

Whether to add a yearly reminder for the person's birthday.

Response attributes

id integer

The ID of the person.

object string

The object type. Always 'person'.

name string

The full name of the person.

first_name string

The first name of the person.

last_name string

The last name of the person.

middle_name string

The middle name of the person.

nickname string

The nickname of the person.

maiden_name string

The maiden name of the person.

prefix string

The name prefix of the person.

suffix string

The name suffix of the person.

age mixed

The age information of the person.

how_we_met string

How you met this person.

can_be_deleted boolean

Whether the person can be deleted.

is_listed boolean

Whether the person is listed.

created_at integer

The date and time the object was created, in Unix timestamp format.

updated_at integer

The date and time the object was last updated, in Unix timestamp format.

PATCH /api/persons/{person}/age
{
"data": {
"id": 1 ,
"object": "person" ,
"name": "Chandler Bing" ,
"first_name": "Chandler" ,
"last_name": "Bing" ,
"middle_name": "Muriel" ,
"nickname": "Chan Chan Man" ,
"maiden_name": "Bing" ,
"prefix": "Mr." ,
"suffix": "Jr." ,
"age": {
"age_type": "exact" ,
"age": 35
},
"how_we_met": "College roommate with Ross" ,
"can_be_deleted": true ,
"is_listed": true ,
"physical_appearance": {
"height": "6'0\"" ,
"weight": "175 lbs" ,
"build": "Average" ,
"skin_tone": "Fair" ,
"face_shape": "Oval" ,
"eye_color": "Blue" ,
"eye_shape": "Almond" ,
"hair_color": "Brown" ,
"hair_type": "Straight" ,
"hair_length": "Short" ,
"facial_hair": "Clean-shaven" ,
"scars": "None" ,
"tatoos": "None" ,
"piercings": "None" ,
"distinctive_marks": "None" ,
"glasses": "Occasionally" ,
"dress_style": "Business casual" ,
"voice": "Sarcastic tone"
},
"created_at": 1709251200 ,
"updated_at": 1709251200
}
}
Taylor Swift being happy

Please login to vote.

It's free and will help us improve the page.

Taylor will be proud of you.

Last updated on April 5, 2025.