Skip to content

Fix CLI speech_models format and clarify API key documentation#711

Open
devin-ai-integration[bot] wants to merge 1 commit intomainfrom
devin/1772717286-fix-docs-cli-speech-models-api-key-ui
Open

Fix CLI speech_models format and clarify API key documentation#711
devin-ai-integration[bot] wants to merge 1 commit intomainfrom
devin/1772717286-fix-docs-cli-speech-models-api-key-ui

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Mar 5, 2026

Summary

Addresses two customer-reported documentation issues:

1. CLI speech_models parameter format (cli.mdx)

Customers hit validation errors because the CLI docs didn't show that --speech-models requires list format. Added a usage example and a Note callout in the existing Advanced section clarifying that model names should be space-separated arguments.

2. API key documentation clarity (how-to-get-your-api-key.mdx, account_management.mdx)

Customers were confused by outdated dashboard references and the distinction between "API keys" and "authentication keys." Changes:

  • Updated FAQ URLs from old /dashboard/* paths to current /app/* paths
  • Added a Note clarifying that "API keys" and "authentication keys" are the same thing (in both the FAQ and the main Account Management page)
  • Updated navigation instructions to reference the current sidebar layout
  • Replaced stale "refresh your API key" bullet with a link to Account Management docs

Review & Testing Checklist for Human

  • Verify --speech-models CLI flag syntax: The existing docs use underscores for flags (e.g. --dual_channel), but this PR uses hyphens (--speech-models). Confirm the actual CLI accepts --speech-models universal-3-pro universal-2 as space-separated list arguments (not comma-separated, not repeated flags, not underscored).
  • Verify dashboard URLs: Confirm that https://www.assemblyai.com/app and https://www.assemblyai.com/app/api-keys are the correct current dashboard paths. Note that the signup link still points to /dashboard/signup — verify this is intentional.
  • Check screenshot accuracy: The existing api-key.png screenshot is retained. Verify it still matches the current dashboard UI described in the updated steps (e.g. "click on 'API Keys' in the left sidebar").
  • Verify "authentication keys" terminology: Confirm that "authentication keys" is indeed a term customers encounter in the current UI or older documentation, so the clarification is accurate and helpful.

Notes


Open with Devin

- Add --speech-models usage example with list format to CLI docs
- Update API key FAQ to reflect current dashboard UI (/app URLs)
- Clarify that API keys and authentication keys are the same thing
- Update account_management.mdx to mention authentication keys alias

Co-Authored-By: dylan.duan <dylan.duan@assemblyai.com>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link

github-actions bot commented Mar 5, 2026

Copy link
Contributor Author

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.

Open in Devin Review

@LeeVaughn
Copy link
Collaborator

aside @dylan-duan-aai Hey! What is the status of this PR? Is it something you were experimenting with for automatic updates? It is WIP, ready for review?

1 similar comment
@LeeVaughn
Copy link
Collaborator

aside @dylan-duan-aai Hey! What is the status of this PR? Is it something you were experimenting with for automatic updates? It is WIP, ready for review?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants