Person management
Journal management
API documentation
Account management
Persons
Journal
Update a person's physical appearance
Table of contents
This endpoint lets you update the physical appearance information of a person.
You can update any combination of physical attributes such as height, weight, build, facial features, and other physical characteristics. All fields are optional, however any fields that is not explicitely passed as arguments will be set to null.
Update a person's physical appearance
This endpoint updates the physical appearance information of a person. It will return the updated person in the response.
URL parameters
The ID of the person.
Query parameters
The height of the person (e.g., '6'0"').
The weight of the person (e.g., '175 lbs').
The body build of the person (e.g., 'Athletic', 'Slim').
The skin tone of the person.
The face shape of the person (e.g., 'Oval', 'Round').
The eye color of the person.
The eye shape of the person (e.g., 'Almond', 'Round').
The hair color of the person.
The hair type of the person (e.g., 'Straight', 'Curly').
The hair length of the person (e.g., 'Short', 'Long').
Description of the person's facial hair, if any.
Description of any scars the person may have.
Description of any tattoos the person may have.
Description of any piercings the person may have.
Any distinctive marks or features not covered by other fields.
Whether the person wears glasses and details about them.
The typical dress style of the person.
Description of the person's voice characteristics.
Response attributes
The ID of the person.
The object type. Always 'person'.
The full name of the person.
The first name of the person.
The last name of the person.
The middle name of the person.
The nickname of the person.
The maiden name of the person.
The name prefix of the person.
The name suffix of the person.
The age information of the person.
How you met this person.
Whether the person can be deleted.
Whether the person is listed.
The physical appearance information of the person.
The date and time the object was created, in Unix timestamp format.
The date and time the object was last updated, in Unix timestamp format.
{
"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
}
}
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.