curl --request POST \
--url https://api.example.com/api/people/{person_id}/merge \
--header 'Content-Type: application/json' \
--data '
{
"source_person_ids": [
"<string>"
]
}
'{
"id": "<string>",
"is_hidden": true,
"is_favorite": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"birth_date": "2023-12-25",
"asset_count": 123,
"thumbnail_face_id": "<string>",
"thumbnail_face_url": "<string>",
"asset_urls": {}
}Merges one or more source people into the primary person identified by the URL. All faces from source people are reassigned to the primary person. Source people are deleted. The primary person’s centroid embedding is recalculated.
curl --request POST \
--url https://api.example.com/api/people/{person_id}/merge \
--header 'Content-Type: application/json' \
--data '
{
"source_person_ids": [
"<string>"
]
}
'{
"id": "<string>",
"is_hidden": true,
"is_favorite": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"birth_date": "2023-12-25",
"asset_count": 123,
"thumbnail_face_id": "<string>",
"thumbnail_face_url": "<string>",
"asset_urls": {}
}IDs of the people to merge into the primary person. These people will be deleted after their faces are moved.
1 - 50 elementsSuccessful Response
Represents a person identified through face clustering and recognition.
Unique person identifier with 'person_' prefix
Whether this person should be hidden from the UI
Whether this person is marked as a favorite
When this person record was created
When this person record was last updated
Optional name assigned to this person
Optional birth date of this person
Number of unique photos this person appears in, or null if not computed
ID of the face resource used as this person's thumbnail
URL for this person's profile thumbnail image
Asset variants from this person's thumbnail face. May be null when embedded in an AssetResponse; use /api/people endpoints for full person data.
Show child attributes