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 is accessible only within the project they were created in — An API key from one project will not be able to 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 |
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
- Navigate to the “API Keys” section
- Click the “Create New API Key” button
- Enter a descriptive name for your API key (e.g., “Production API”, “Development API”)
- Click “Create”
Delete an API Key
- Log in to your AssemblyAI Dashboard
- Navigate to the “API Keys” section
- Locate the API key you want to delete
- Click the “Delete” button next to the key
- Confirm the deletion in the popup dialog
This action cannot be undone. Make sure no active applications are using the
key before deletion.
Team Members
You can 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 | ✓ | ✓ | ✗ |
| 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 AssemblyAI Dashboard:- Navigate to the Members section
- 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.
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.
MFA enforcement
Owners and Admins can require all members to use multi-factor authentication (MFA) by enabling the Require MFA for all members setting on the account. 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.Reporting
Get insights into your usage and spend to track and manage costs effectively with the reporting tool in the AssemblyAI dashboard. You can analyze your usage and spend data at different levels of granularity:- Account
- Product (e.g., Speech-to-text, Streaming, LLM Gateway)
- Models (e.g., Best, Claude 3.5 Sonnet, etc.)
- Project
- API key
Usage and spend data in the dashboard updates every 2 minutes. For streaming, a session must be closed before its usage populates.
Changing your account email
To change your account email address, email support@assemblyai.com from your current registered email address and specify the new address you’d like to use.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.
How to delete your account
If you are the sole member of your account, you can delete it through the Dashboard:- Log in to your AssemblyAI Dashboard
- Navigate to the Account page
- Click the Delete Account button
- Follow the prompts to complete the account deletion process
Account deletion is permanent and cannot be undone. Make sure to back up any important information before proceeding with deletion.