Update AssemblyAI skill: Sync keyterms_prompt/timestamps, async language defaults, Voice Agent voice roster + Sessions API#19
Merged
dlange-aai merged 1 commit intoJul 21, 2026
Conversation
…age defaults, Voice Agent voice roster + Sessions API
Sync docs since 2026-07-10 changed the API surface in a few places the skill
described incorrectly, and added new endpoints:
- Sync STT keyterms: the documented field is `keyterms_prompt` (with `keyterms`
/ `word_boost` accepted as aliases, one of the three). The skill previously
asserted Sync uses `word_boost` and *not* `keyterms_prompt` — now corrected
in SKILL.md and api-reference.md (config table + example).
- Sync STT word timestamps are now opt-in via `config.timestamps` (default
`false`); `start`/`end` are omitted from `words` unless set. Fixed the
response shape/example in SKILL.md and api-reference.md.
- Async `language_code` / `language_detection` no longer default to
`en_us` / `false`. Omitting `language_code` auto-runs detection; the two are
mutually exclusive; `language_confidence_threshold` requires detection on.
Updated the param table, Language Detection section, and a new gotcha.
- `remove_audio_tags` now defaults to `"all"` (annotations stripped by
default; pass `null` to keep them). Documented enum + default.
- Webhook auth header constraints (length/charset, mutual + webhook_url
requirement) added to the webhooks section.
- Param dependencies documented: redact_pii→format_text, speaker_labels→
punctuate, sentiment_analysis→punctuate, speaker_options/speakers_expected
mutual exclusivity, redact_static_entities limits.
- Voice Agent voice roster refreshed (July 2026): old roster (ivy/james/
tyler/… ) is now deprecated; new current roster (anna/alba/…/paul/vera,
giovanni/lola/juergen/rafael/estelle). Output languages now 6 (EN/IT/ES/
DE/PT/FR). Updated voice-agents.md and examples off deprecated `ivy`.
- Voice Agent stored-agent REST create `voice` is an object
`{"voice_id": "..."}`, not a bare string (WS `output.voice` stays a string).
Corrected api-reference.md section 17 + added a common-mistake row.
- New Sync `GET /warm` connection pre-warming endpoint documented.
- New Voice Agent Sessions API (GET/DELETE /v1/sessions, artifacts) documented.
LLM Gateway model list verified current (no drift). Streaming voice_focus /
previous_context_n_turns already accurate.
dlange-aai
merged commit Jul 21, 2026
44a3afa
into
update-assemblyai-skill-2026-07-10
1 check passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Scheduled docs-sync run against the current assemblyai-docs
api-reference/+ root OpenAPI/AsyncAPI specs (docs repo at 2026-07-20). Covers changes merged since the last skill update (2026-07-10). Stacked onupdate-assemblyai-skill-2026-07-10(PR #18).Correctness fixes
keyterms_prompt(notword_boost). The docs now documentkeyterms_promptas the field, withkeyterms/word_boostaccepted as aliases — "provide only one of the three." The skill previously asserted the opposite (Sync usesword_boost, notkeyterms_prompt). Fixed inSKILL.md(Sync config fields + Common Mistakes) andapi-reference.md(config table + example curl). (docs #216)config.timestamps(defaultfalse) —start/endare omitted from eachwordsobject unless set. The skill showed them as always present. Fixed the response shape/example inSKILL.mdandapi-reference.md. (docs #210)language_code/language_detectiondefaults changed. Neither defaults toen_us/falseanymore: omittinglanguage_codeauto-runs detection, the two are mutually exclusive, andlanguage_confidence_thresholdrequires detection on. Updated the param table, the Language Detection section, and added a gotcha inSKILL.md. (docs #231)remove_audio_tagsnow defaults to"all"(all inline annotations stripped by default; passnullto keep them). Enumall/speaker/nulldocumented. (docs #238)voiceis an object{"voice_id": "..."}, not a bare string (the WebSocketsession.output.voiceremains a plain string). Correctedapi-reference.md§17 + added a Common-Mistakes row.Voice roster refresh (July 2026)
ivy,james,tyler,winter,bella,david,arjun, …) is now deprecated (still functional). New current roster: Englishanna/alba/charles/eve/george/jane/jean/mary/michael(🇺🇸),paul/vera(🇬🇧); language-specificgiovanni(IT),lola(ES),juergen(DE),rafael(PT),estelle(FR). Officially supported output languages are now 6 (EN/IT/ES/DE/PT/FR). Updatedvoice-agents.mdand moved examples off the deprecated defaultivy. (docs #214, #229)New endpoints / features documented
GET /warmconnection pre-warming endpoint (unauthenticated, idempotent; warm right before transcribing). (docs #217, #221)GET /v1/sessions,GET /v1/sessions/{id},DELETE /v1/sessions/{id}with recording/timeline/metadata artifacts (pre-signed URLs). (docs #226)webhook_urlrequirement) added. (docs #238)redact_pii→format_text,speaker_labels→punctuate,sentiment_analysis→punctuate,speaker_options/speakers_expectedmutual exclusivity,redact_static_entitieslimits. (docs #235, #236, #237)Verified already-current (no change)
available-models.mdxexactly (Claude Opus 4.7/4.6/Sonnet 4.6/…, GPT-5.5/5.2/…, Gemini 3.5 Flash/…, Qwen3, Kimi K2.5).voice_focus/voice_focus_threshold(default 0.7) andprevious_context_n_turnsdefault 5 already accurate.redact_pii_subvalueentity_namealready correct.Files changed
SKILL.mdreferences/api-reference.mdreferences/audio-intelligence.mdreferences/voice-agents.md