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

uuidstringOptional

namestringOptional

identity_typeenumOptional

visibilityenumOptional

notesstring or nullOptional

voice_profile_idstring or nullOptional

created_atdatetimeOptional

updated_atdatetimeOptional

project_countintegerOptional

voice_sampleslist of objectsOptional

face_photoslist of objectsOptional

reference_videoslist of objectsOptional

embeddingslist of objectsOptional

Per-modality embedding processing status

projectslist of objectsOptional

Errors

400

Bad Request Error

404

Not Found Error

422

Unprocessable Entity Error