Update a pronunciation item
Partial update — only included fields are changed. group_id cannot
be changed via this endpoint; create a new pronunciation item in the
target group instead.
API key in the Authorization: Bearer <key> header.
Keys are created in the SMAO dashboard (Settings → API Keys).
In: header
Path Parameters
^[a-f0-9]{24}$The written single-token form to match. Whitespace and angle
brackets (<, >) are rejected.
^[^\s<>]+$1 <= length <= 200Angle brackets (<, >) are rejected. Must be empty when the final spell_out state is true.
length <= 1000International Phonetic Alphabet transcription. Applied on v2 (KugelAudio) voices; ignored on v1 (ElevenLabs) voices. Must be empty when the final spell_out state is true.
length <= 1000When true, the matched word is spoken letter by letter — API is spoken as A, P, I.
Speaking-rate override. Send null to return to the default inherited speed, or medium for an explicit normal-speed span.
null | "slow" | "medium" | "fast"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://api.smao.ai/api/v1/pronunciation/string" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"id": "65f8fa6f1a9d8e0012ab34cd",
"group_id": "65a1234567890abcdef01234",
"group_name": "Brand names",
"word": "smao",
"replacement": "ess-mao",
"ipa": "ɛsmaʊ",
"spell_out": false,
"rate": null,
"case_sensitive": false,
"active": true,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
}{
"error": {
"code": "validation_failed",
"message": "Validation failed"
}
}{
"error": {
"code": "unauthorized",
"message": "Missing API key"
}
}{
"error": {
"code": "subscription_required",
"message": "This feature is not available in your current subscription. Please upgrade to a higher plan"
}
}{
"error": {
"code": "forbidden",
"message": "No permission"
}
}{
"error": {
"code": "not_found",
"message": "Not found"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred."
}
}