Add reference media | Resemble

curl -X POST https://app.resemble.ai/api/v2/identity/uuid/attachments \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: multipart/form-data" \
     -F modality="voice" \
     -F file=@string

{
  "uuid": "string",
  "name": "string",
  "identity_type": "person",
  "visibility": "team",
  "notes": "string",
  "voice_profile_id": "string",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "project_count": 1,
  "voice_samples": [
    {
      "id": 1,
      "filename": "string",
      "byte_size": 1,
      "content_type": "string"
    }
  ],
  "face_photos": [
    {
      "id": 1,
      "filename": "string",
      "byte_size": 1,
      "content_type": "string"
    }
  ],
  "reference_videos": [
    {
      "id": 1,
      "filename": "string",
      "byte_size": 1,
      "content_type": "string"
    }
  ],
  "embeddings": [
    {
      "modality": "voice",
      "status": "string",
      "attachment_count": 1,
      "computed_at": "2024-01-15T09:30:00Z"
    }
  ],
  "projects": [
    {
      "uuid": "string",
      "name": "string"
    }
  ]
}

Attach a reference media file (voice sample, face photo, or reference video) to an identity. The modality’s embedding recomputes asynchronously; the media becomes searchable once its embedding status is ready.

Authentication

AuthorizationBearer

API token from https://app.resemble.ai/account/api

Path parameters

uuidstringRequired

Request

This endpoint expects a multipart form containing a file.

modalityenumRequired

Allowed values:

filefileRequired

The media file to attach

Response

Media attached; returns the updated identity

uuidstring

namestring

identity_typeenum

visibilityenum

notesstring or null

voice_profile_idstring or null

created_atdatetime

updated_atdatetime

project_countinteger

voice_sampleslist of objects

face_photoslist of objects

reference_videoslist of objects

embeddingslist of objects

Per-modality embedding processing status

projectslist of objects

Errors

400

Bad Request Error

404

Not Found Error

422

Unprocessable Entity Error