- APIs — playgrounds, getting started resources, logs, and comparison tools for Voice Agents, Realtime STT, Pre-Recorded STT, and the LLM Gateway.
- Workspace — account-wide configuration, split into Manage (API keys, rate limits, cost, usage) and Settings (personal info, organization & access, members, billing, alerts, activity logs).
APIs section
Each API in the sidebar has its own set of tools. They aren’t covered in detail here — see the corresponding product docs — but the options you’ll see are:- Playground — an in-browser environment for testing the API without writing code.
- Get Started — a quickstart and links to additional resources for that API.
- Logs — historical records of past requests (async transcripts, realtime sessions, etc.).
- Compare — side-by-side comparison of results across models (Pre-Recorded STT).
- Truth File Corrector — compare an async STT transcript against a ground-truth file (Pre-Recorded STT).
Workspace > Manage
The Manage area is where you configure how your account talks to the API.API Keys
API keys are unique credentials that authenticate requests to the API. Each API key is associated with a specific project, ensuring secure and controlled access. You can create and delete API keys based on your plan:| Usage limits | Free | PAYG | Contracted | Enterprise |
|---|---|---|---|---|
| Number of API keys | 2 | 4 | 25 | Custom |
Create a new API key
- Log in to your AssemblyAI dashboard.
- In the sidebar, go to Workspace > Manage > API Keys.
- Click Create New API Key.
- Enter a descriptive name (for example,
Production APIorDevelopment API). - Click Create.
Delete an API key
- Log in to your AssemblyAI dashboard.
- In the sidebar, go to Workspace > Manage > API Keys.
- Locate the API key you want to delete and click Delete.
- Confirm the deletion in the popup dialog.
This action cannot be undone. Make sure no active applications are using the
key before deletion.
Each project must have at least one active API key at all times. You cannot delete the last remaining key in a project.
Rate limits
The Rate Limits page shows the request limits in effect for your account. For details on how rate limits work and how to handle them in your application, see the Pre-Recorded STT rate limits and Real-time STT rate limits pages.Cost and usage
The Cost and Usage pages provide a breakdown of your spend and usage so you can track and manage costs effectively. You can analyze the data at different levels of granularity:- Account
- Product (e.g., Speech-to-Text, Streaming, LLM Gateway)
- Models (e.g., Best, Claude Sonnet 4.6, etc.)
- Project
- API key
Usage and spend data updates every 2 minutes. For streaming, a session must be closed before its usage populates.
Workspace > Settings
The Settings area covers personal account info, organization configuration, team membership, data controls, billing, alerts, and activity logs.Personal Info
Manage the details tied to your individual user:- Change the email address associated with your account.
- Change your password.
- Set up or update multi-factor authentication (MFA).
- Log out.
Organization & Access
Control how members authenticate and what protections are enforced on the organization:- Authentication methods available to members.
- MFA enforcement for the organization.
- Single sign-on (SSO) configuration.
- Danger Zone — delete your account or organization. See Deleting your account or organization below.
Members
Invite teammates to your account with role-based access control. Each member gets their own login and has a single role per account. A single person can belong to multiple accounts with different roles in each. For example, an Owner of one organization and a Reader on another.Projects, API keys, billing, and all other account configuration are owned by the account, not by individual members. Adding, removing, or changing a member’s role has no effect on any of these.
Roles
There are three roles. Each account has exactly one Owner, and a member has exactly one role per account:| Role | Permissions |
|---|---|
| Owner | Full control, including billing, account deletion, and ownership transfer. There is exactly one Owner per account. |
| Admin | Full administrative access — can do everything an Owner can, except delete the account. |
| Reader | Read-only access. Can view projects, API keys, usage, and transcriptions, but cannot create, edit, or delete. This is the default role for new invites. |
| Action | Owner | Admin | Reader |
|---|---|---|---|
| View members, projects, API keys, usage, transcriptions | ✓ | ✓ | ✓ |
| Invite, update, or remove members | ✓ | ✓ | ✗ |
| Create, edit, or delete projects, tokens, alerts | ✓ | ✓ | ✗ |
| View or edit billing, autopay, invoices | ✓ | ✓ | ✗ |
| Manage Data Controls (opt out of model training, set TTL, sign a BAA) | ✓ | ✓ | ✗ |
| Delete the account | ✓ | ✗ | ✗ |
Ownership transfer cannot be performed self-serve. Contact support@assemblyai.com to request a transfer.
Member limits
The number of members (active + pending invites combined) per account depends on your plan:| Plan | Max members |
|---|---|
| Free | 2 |
| PAYG | 20 |
| Contracted | 20 |
| Enterprise | 20 |
Inviting a member
Owners and Admins can invite team members from the dashboard:- Go to Workspace > Settings > Members.
- Click Invite Member.
- Enter the invitee’s email address and select a role.
- Click Send Invite.
Revoking an invite
To cancel a pending invite, use the delete action on the pending invite entry in the Members list. There is no separate revoke action. Deleting handles both pending invites and active members.Removing a member
Owners and Admins can remove any non-Owner member from the Members list.The Owner cannot be removed without first transferring ownership to another member. To transfer ownership, contact support@assemblyai.com. After a transfer, the previous Owner is automatically demoted to Admin.
MFA enforcement
Owners and Admins can require all members to use multi-factor authentication (MFA) from Workspace > Settings > Organization & Access. When enabled, members who haven’t set up MFA will be prompted to do so on their next login. The Members list shows the MFA enrollment status for each member.Data Controls
The Data Controls page lets Owners and Admins manage how AssemblyAI retains and uses your data — opt out of the model improvement program, set a time-to-live (TTL) for audio and transcripts, and review and sign a Business Associate Agreement (BAA). These controls are available self-serve, at no additional cost, on paid plans. See Data Controls for details.Billing
The Billing page shows:- Your current account balance.
- Credit card on file (add or update your payment method).
- Auto-pay configuration.
- Billing history and invoices.
Alerts
Set up usage and balance alerts so you’re notified before your balance runs low or your usage crosses a threshold you define.Activity Logs
The Activity Logs page provides an audit trail of account activity — useful for reviewing administrative changes, sign-ins, and other notable events.Projects
Projects can be used to isolate data for different environments or applications, e.g., production, staging, or development. Each project has its own API keys, allowing for better organization and data access control. Transcripts and other project-specific data are accessible only within the project they were created in — an API key from one project cannot access historical transcripts or data from another project. This separation maintains data security and prevents unintended cross-project access. This project-level scoping also applies to files uploaded via the/upload endpoint. An API key can only transcribe files that were uploaded within the same project. If you need to transcribe the same file across multiple projects, you must upload it separately in each project.
You can create, rename, and delete projects based on your plan:
| Usage limits | Free | PAYG | Contracted | Enterprise |
|---|---|---|---|---|
| Number of projects | 2 | 2 | 5 | Custom |
Account switching
When you sign in, AssemblyAI logs you straight into your account, or shows you a list to choose from if you belong to multiple accounts. If you belong to multiple accounts, an organization switcher is available in the dashboard so you can move between them without logging out.Migrating existing accounts to multi-user
If you already have multiple AssemblyAI accounts, the recommended path is to designate one as your primary account and invite your other users into it. A few important notes:- Existing accounts are not automatically merged. Each account retains its own projects, API keys, transcripts, and billing history.
- Users invited to another account will retain their original account. They may see multiple accounts in the account switcher after accepting an invite.
- Going forward, manage billing changes in a single account to avoid confusion and unexpected charges.
- To move workflows, switch the API keys in your applications to point to the primary account’s API keys.
Changing your account email
You can change your account email address yourself from Workspace > Settings > Personal Info. You can also reach this page by clicking the portrait icon in the top-right corner of the dashboard.The Owner’s email address is used for billing communications. If you transfer account ownership to another member, billing emails go to the new Owner’s address.
Deleting your account or organization
If you are the sole member of your account, you can delete it from the dashboard:- Log in to your AssemblyAI dashboard.
- In the sidebar, go to Workspace > Settings > Organization & Access.
- Scroll to the Danger Zone.
- Click the option to delete your account or organization and follow the prompts.
Account deletion is permanent and cannot be undone. Make sure to back up any important information before proceeding with deletion.