Permission Scopes

What is a permission scope?

A permission scope is a specific action that can be allowed or denied for a user. Instead of a simple on/off role switch, the system uses fine-grained scopes — so a user can generate video without being able to delete users, and another user can record audio without being able to edit the script.

Scopes look like resource:action, for example:

• voiceover:generate — generate voiceover audio
• scene_block:edit — edit a scene block's text and timing
• episode:delete — delete an episode

Why does this matter to me?

When you try to do something and the button isn't there — or you get a "permission denied" message — it means your role doesn't have the required scope. This is intentional: it prevents accidental changes and keeps the workflow clean.

How scopes are assigned

1. Your role comes with a default set of scopes (see Your Role)
2. An Administrator can add or remove individual scopes for your account without changing your role

Common scopes explained

Content creation

Scope	What it allows
scene:create	Add new scenes to an episode
scene_block:create	Add dialog or action blocks to a scene
scene_block:edit	Change block text, emotion, or timing
scene_block:delete	Delete a block permanently

Visual production

Scope	What it allows
scene_block:frame:generate	Generate a start or end frame image using AI
scene_block:frame:delete	Delete a generated frame image
scene_block:video:generate	Generate a video clip from frame images
scene_block:video:delete	Delete a generated video
character:image:generate	Generate a character portrait using AI
location:image:generate	Generate a location background using AI

Audio

Scope	What it allows
voiceover:generate	Generate AI voiceover for a dialog block
voiceover:delete	Delete a saved voiceover
sound:create	Generate a new sound effect
sound:edit	Rename a sound effect
sound:delete	Delete a sound effect

Episodes & projects

Scope	What it allows
episode:create	Create a new episode
episode:edit	Edit episode name, status, duration
episode:delete	Delete an episode
episode:assign	Assign users to roles for an episode
project:create	Create a new project
project:edit	Edit project details

Comments

Scope	What it allows
comment:create	Post a comment on a scene block
comment:resolve	Mark a comment as resolved
comment:delete	Delete a comment

Admin

Scope	What it allows
admin:users:view	View the users list
admin:users:create	Create new user accounts
admin:users:edit	Edit user profiles and roles
admin:users:delete	Delete users
admin:roles:view	View the roles list
admin:role:permissions:manage	Change which scopes a role has
admin:user:permissions:manage	Add/remove individual scope overrides for a user
template:edit	Edit the global assignment template

---

:::info Missing access? If you need a permission that your role doesn't include, ask your Administrator. They can add a specific scope override to your account without changing your role. :::