> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecontra.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Face

> Add a face image to a face list — the biometric template is hashed and stored irreversibly.

Face uploads are a separate endpoint because the request includes binary data and the storage path is biometric-template-hashed.

## Request

```bash theme={null}
curl -X POST https://identity.contra.id/v1/lists/$UUID/entries/face \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "image":     "data:image/jpeg;base64,/9j/4AAQ…",
    "reason":    "duplicate account fraud",
    "session_id":"sess_b3f1c2a4"
  }'
```

## Response · 201

```json theme={null}
{
  "uuid":             "ent_face_a1b2…",
  "fingerprint":      "sha256:abc123…",
  "raw_image_stored": false,
  "added_at":         1748566800
}
```

<Note>
  Contra stores **only the irreversible biometric template hash**, never the raw image. Matching is via cosine similarity against the template; the original photo cannot be reconstructed.
</Note>