Troubleshooting Guide

Fixing ElevenLabs missing_permission Error

To view your character usage, quota reset dates, and subscription tier in our dashboard, your ElevenLabs API key must have the user_read permission enabled.

Identify Your Key Type

Instructions differ depending on whether you are using a Personal Key or a Service Account.

Path A

Personal / Starter

Use this if you are an individual user.

Path B

Workspace / Pro

Use this for Enterprise or Scale accounts.

A

For Personal Accounts

  1. 01.Go to Developers > API Keys in the menu.
  2. 02.Find your key and select Edit from the (...) menu.
  3. 03.Find the Restrict Key toggle and turn it OFF.

Personal accounts do not have granular scope checkboxes. Disabling restrictions is the only way to allow metadata read access for these keys.

B

For Service Accounts (Workspace)

  1. 01.Go to Workspace Settings > Service Accounts.
  2. 02.Select your account and click Modify Permissions.
  3. 03.Check the box for user_read and save.

Finish in Dashboard

Go back to your API Key Health Dashboard, find your ElevenLabs key, and click the **Refresh** icon.

API Key Health never stores your raw password or session cookies from ElevenLabs. We only use the API key you provide with the scopes you explicitly grant. Enabling `user_read` is safe and only shares subscription-level metadata.