Update person aliases | Coactive AI

curl -X PUT https://api.coactive.ai/api/v0/celebrity-detection/person/aliases \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "person_id": "0d73b5d4-0f1b-11ed-861d-0242ac120002",
  "aliases": [
    "Johnny",
    "JD",
    "John"
  ]
}'

{
  "id": "0d73b5d4-0f1b-11ed-861d-0242ac120002",
  "name": "John Doe",
  "aliases": [
    "John Doe",
    "John Doe Jr."
  ],
  "upload_ids": [
    "0d73b5d4-0f1b-11ed-861d-0242ac120002",
    "0d73b5d4-0f1b-11ed-861d-0242ac120003"
  ],
  "ingested_images": [
    {
      "coactive_image_id": "0d73b5d4-0f1b-11ed-861d-0242ac120002",
      "dataset_id": "0d73b5d4-0f1b-11ed-861d-0242ac120003"
    }
  ],
  "status": "active",
  "created_user_id": "auth0|674fa0455c7cd29dd8e49ae3",
  "created_dt": "2025-12-10T12:07:32.066180+00:00"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

person_idstringRequiredformat: "uuid"

Person ID

aliaseslist of stringsOptional

Updated list of person aliases

Response

Successful Response

idstringformat: "uuid"

Person ID

namestring

Person name

aliaseslist of strings

Person aliases

upload_idslist of strings

Upload IDs of the person's images

ingested_imageslist of objects

Ingested images of the person

statusenum

Person status

Allowed values:

created_user_idstring

User ID who created the person

created_dtstringformat: "date-time"

Date and time the person was created

Errors

422

Unprocessable Entity Error