---
title: "Add reference media"
method: POST
path: "/identity/{uuid}/attachments"
tags: ["identity"]
---

# Add reference media

`POST /identity/{uuid}/attachments`

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.

## Path parameters

- `uuid` string, required

## Headers

- `Authorization` string, required

## Response `201`

Media attached; returns the updated identity

- Identity — A multimodal identity profile
  - `uuid` string
  - `name` string
  - `identity_type` 'person' | 'brand'
  - `visibility` 'team' | 'global'
  - `notes` string, nullable
  - `voice_profile_id` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `project_count` integer
  - `voice_samples` IdentityAttachment[]
    - `id` integer
    - `filename` string
    - `byte_size` integer
    - `content_type` string
  - `face_photos` IdentityAttachment[]
    - `id` integer
    - `filename` string
    - `byte_size` integer
    - `content_type` string
  - `reference_videos` IdentityAttachment[]
    - `id` integer
    - `filename` string
    - `byte_size` integer
    - `content_type` string
  - `embeddings` IdentityEmbeddingsItems[] — Per-modality embedding processing status
    - `modality` 'voice' | 'face' | 'video'
    - `status` string
    - `attachment_count` integer
    - `computed_at` string, date-time, nullable
  - `projects` IdentityProjectsItems[]
    - `uuid` string
    - `name` string

## Other responses

- `400` — Missing or invalid modality, or missing file
- `404` — Identity not found
- `422` — Face photo limit reached (a person identity accepts at most 5 face photos)

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-26** `5e92bebbaf1f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/identity/:uuid/attachments/post.md)

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)