Skip to main content
PATCH
/
api
/
people
/
{person_id}
{
  "id": "<string>",
  "name": "<string>",
  "birth_date": "2023-12-25",
  "is_hidden": true,
  "is_favorite": true,
  "thumbnail_face_id": "<string>",
  "thumbnail_face_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Path Parameters

​
person_id
string
required

Body

application/json
​
name
string | null
​
birth_date
string<date> | null
​
is_hidden
boolean | null
​
is_favorite
boolean | null
​
thumbnail_face_id
string | null

Response

Successful Response

Represents a person identified through face clustering and recognition.

​
id
string
required

Unique person identifier with 'person_' prefix

​
is_hidden
boolean
required

Whether this person should be hidden from the UI

​
is_favorite
boolean
required

Whether this person is marked as a favorite

​
created_at
string<date-time>
required

When this person record was created

​
updated_at
string<date-time>
required

When this person record was last updated

​
name
string | null

Optional name assigned to this person

​
birth_date
string<date> | null

Optional birth date of this person

​
thumbnail_face_id
string | null

ID of the face resource used as this person's thumbnail

​
thumbnail_face_url
string | null

URL for this person's profile thumbnail image

⌘I