Bulk Create from ZIP

POST https://app.resemble.ai/api/v2/pronunciations/bulk

Upload multiple pronunciations at once. Each audio file in the ZIP becomes a pronunciation — the filename (without extension) is used as the word.

Request Body (multipart/form-data)

$
# ZIP structure:
$
#   mounjaro.wav      -> word: "mounjaro"
$
#   abemaciclib.wav   -> word: "abemaciclib"
$
#   paracetamol.flac  -> word: "paracetamol"
$
$
curl -X POST https://app.resemble.ai/api/v2/pronunciations/bulk \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -F "zip=@pronunciations.zip"

Response (201 Created)

1
{
2
  "success": true,
3
  "total_created": 3,
4
  "total_errors": 0,
5
  "items": [
6
    {
7
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8
      "word": "mounjaro",
9
      "status": "pending",
10
      "active": true,
11
      "audio_url": "https://...",
12
      "created_at": "2026-03-12T00:00:00.000Z",
13
      "updated_at": "2026-03-12T00:00:00.000Z"
14
    }
15
  ],
16
  "errors": []
17
}

Each successfully created pronunciation starts with status: "pending". Any files that fail validation are reported in the errors array with a reason.