Skip to main content

Scopes

Scopes use the resource:action format. The assignable API-key registry is derived from the live RBAC registries and then filtered by key kind.

Assignment Rules​

A key can never be created with more scope than its creator holds. Unknown scopes are rejected with 400 and the VALIDATION_ERROR code. The assignable registry does not include wildcard scopes.

The deny-list is never assignable to any API-key kind:

ScopeReason
apikeys:createAPI keys must not mint more API keys.
apikeys:editAPI keys must not manage the API-key credential family.
tokens:createAPI keys must not mint popout tokens.
account:deleteAPI keys must not delete the tenant they automate.

GET /v1/api-keys/permissions?kind=personal|service|developer returns the assignable registry for each key kind. GraphQL apiKeyAssignablePermissions(kind: ApiKeyKind!) supports PERSONAL and SERVICE; the generated GraphQL enum has no DEVELOPER member, so the developer registry is available through REST.

Registry​

Events​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
events:readRead EventsYesYesNo
events:createCreate EventsYesYesNo
events:userinfoEvent User InfoYesYesNo

Overlays​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
overlays:readRead OverlaysYesYesNo
overlays:createCreate OverlaysYesYesNo
overlays:editEdit OverlaysYesYesNo
overlays:deleteDelete OverlaysYesYesNo
overlays:access-readRead Overlay AccessYesYesNo
overlays:access-grantGrant Overlay AccessYesYesNo
overlays:access-revokeRevoke Overlay AccessYesYesNo

Spotify​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
spotify:readRead SpotifyYesYesNo
spotify:playbackSpotify PlaybackYesYesNo
spotify:volumeSpotify VolumeYesYesNo
spotify:queueSpotify QueueYesYesNo
spotify:playlistSpotify PlaylistsYesYesNo
spotify:deviceSpotify DevicesYesYesNo
spotify:workerSpotify WorkerYesYesNo

Chat​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
chat:readRead ChatYesYesNo
chat:writeWrite ChatYesYesNo
chat:userinfoChat User InfoYesYesNo
chat:deleteDelete Chat MessagesYesYesNo
chat:banBan Chat UsersYesYesNo
chat:timeoutTimeout Chat UsersYesYesNo
chat:notesChat User NotesYesYesNo
chat:raidCancel RaidsYesYesNo
chat:refresh_userRefresh User ProfileYesYesNo
chat:pollEnd PollsYesYesNo
chat:predictionEnd PredictionsYesYesNo

Connections​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
connections:readRead ConnectionsYesYesNo
connections:createCreate ConnectionsYesYesNo
connections:editEdit ConnectionsYesYesNo
connections:deleteDelete ConnectionsYesYesNo

Settings​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
settings:readRead SettingsYesYesNo
settings:editEdit SettingsYesYesNo

Account​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
account:readRead Account SettingsYesYesNo
account:editEdit Account SettingsYesYesNo
account:deleteDelete AccountNo, deny-listedNo, deny-listedNo, deny-listed

Plan​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
plan:readView Plan & BillingYesYesNo
plan:editChange PlanYesYesNo

Members​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
members:readRead MembersYesYesNo
members:createCreate InvitesYesYesNo
members:editEdit MembersYesYesNo
members:deleteDelete MembersYesYesNo

Roles​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
roles:readRead RolesYesYesNo
roles:editEdit RolesYesYesNo
roles:deleteDelete RolesYesYesNo

Login Assignments​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
login-assignments:readView Login AssignmentsYesYesNo
login-assignments:createAssign Login ConnectionsYesYesNo
login-assignments:deleteRemove Login AssignmentsYesYesNo

Uploads​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
uploads:readRead UploadsYesYesNo
uploads:createCreate UploadsYesYesNo
uploads:deleteDelete UploadsYesYesNo

Rewards​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
rewards:readRead RewardsYesYesNo
rewards:createCreate RewardsYesYesNo
rewards:editEdit RewardsYesYesNo
rewards:deleteDelete RewardsYesYesNo

Tokens​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
tokens:readRead TokensYesYesNo
tokens:createCreate TokensNo, deny-listedNo, deny-listedNo, deny-listed
tokens:editEdit TokensYesYesNo
tokens:deleteDelete TokensYesYesNo

API Keys​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
apikeys:readRead API KeysYesYesNo
apikeys:createCreate API KeysNo, deny-listedNo, deny-listedNo, deny-listed
apikeys:editEdit API KeysNo, deny-listedNo, deny-listedNo, deny-listed
apikeys:deleteDelete API KeysYesYesNo

Automations​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
automations:readRead AutomationsYesYesNo
automations:createCreate AutomationsYesYesNo
automations:editEdit AutomationsYesYesNo
automations:deleteDelete AutomationsYesYesNo
automations:executeExecute AutomationsYesYesNo

OBS​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
obs:readView OBS ConfigYesYesNo
obs:editEdit OBS ConfigYesYesNo
obs:deleteDelete OBS ConfigYesYesNo
ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
copyright:readView CopyrightYesYesNo
copyright:editEdit Copyright ListsYesYesNo
copyright:deleteDelete Copyright EntriesYesYesNo
copyright:voteVote on SongsYesYesNo
copyright:reportCreate Copyright ReportsYesYesNo
copyright:recommendRecommend SongsYesYesNo

Bot Modules​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
bot-modules:readView Bot ModulesYesYesNo
bot-modules:editEdit Bot ModulesYesYesNo

Bot Commands​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
bot-commands:readView Bot CommandsYesYesNo
bot-commands:createCreate Bot CommandsYesYesNo
bot-commands:editEdit Bot CommandsYesYesNo
bot-commands:deleteDelete Bot CommandsYesYesNo

Bot Connections​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
bot-connections:readView Bot ConnectionsYesYesNo
bot-connections:createCreate Bot ConnectionsYesYesNo
bot-connections:deleteDelete Bot ConnectionsYesYesNo

StreamElements​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
se-tokens:readView SE TokensYesYesNo
se-tokens:createCreate SE TokensYesYesNo
se-tokens:deleteDelete SE TokensYesYesNo

Extension Developer​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
extension-dev:readView Developer DashboardYesYesYes
extension-dev:createCreate ExtensionsYesYesYes
extension-dev:editEdit ExtensionsYesYesYes
extension-dev:deleteDelete ExtensionsYesYesYes
extension-dev:publishPublish ExtensionsYesYesYes
extension-dev:analyticsView Extension AnalyticsYesYesYes
extension-dev:payoutsManage Extension PayoutsYesYesYes

Extension Store​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
extension-store:readBrowse Extension StoreYesYesNo
extension-store:installInstall ExtensionsYesYesNo
extension-store:uninstallUninstall ExtensionsYesYesNo
extension-store:configureConfigure ExtensionsYesYesNo
extension-store:reviewReview ExtensionsYesYesNo

Extension Data​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
extension-data:readRead Extension DataYesYesNo
extension-data:editEdit Extension DataYesYesNo

Widgets​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
widgets:readView WidgetsYesYesNo
widgets:createCreate WidgetsYesYesNo
widgets:editEdit WidgetsYesYesNo
widgets:deleteDelete WidgetsYesYesNo
widgets:access-readRead Widget AccessYesYesNo
widgets:access-grantGrant Widget AccessYesYesNo
widgets:access-revokeRevoke Widget AccessYesYesNo

Sounds​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
sounds:readView SoundsYesYesNo
sounds:createUpload SoundsYesYesNo
sounds:editEdit SoundsYesYesNo
sounds:deleteDelete SoundsYesYesNo
sounds:playPlay SoundsYesYesNo

Stream History​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
history:readRead Stream HistoryYesYesNo
history:shareShare History ReportsYesYesNo
history:exportExport History ReportsYesYesNo
history:deleteDelete Stream HistoryYesYesNo

Public Stats​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
public-stats:readRead Public Stats SettingsYesYesNo
public-stats:editEdit Public Stats SettingsYesYesNo

Audit Log​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
audit-log:readRead Audit LogYesYesNo

Ideas​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
ideas:readRead IdeasYesNoNo
ideas:createCreate IdeasYesNoNo
ideas:editEdit Own IdeasYesNoNo
ideas:deleteDelete Own IdeasYesNoNo
ideas:voteVote on IdeasYesNoNo

Idea Comments​

ScopeLabelPersonal lm_usr_*Service lm_svc_*Developer lm_dev_*
ideas:comment_readRead Idea CommentsYesNoNo
ideas:comment_createCreate Idea CommentsYesNoNo
ideas:comment_editEdit Own Idea CommentsYesNoNo
ideas:comment_deleteDelete Own Idea CommentsYesNoNo
ideas:comment_voteVote on Idea CommentsYesNoNo