Skip to main content

Episode Creators Modal

The Creators Modal lets you assign users to roles for a specific episode, organize them into stages, and apply the global assignment template.

Opening the modal​

From the episodes list, click the Assign button on any episode. Requires episode:assign permission.

Concepts​

Roles and stages​

Each episode has a list of tasks — one per role. Tasks are grouped into stages that define the workflow order. Roles within the same stage work in parallel; later stages wait for earlier stages to complete.

User assignment​

Each role (task) can have a user assigned to it, or left unassigned. An unassigned role is still tracked — the task exists in the system, just without a user.

What happens on Save​

The modal only makes API requests for things that actually changed:

ChangeRequest
Role removedDELETE /api/tasks/:taskId (cascades to episode_tasks)
Role added (new)POST /api/tasks → POST /api/tasks/:id/episodes
User changed (or cleared)PATCH /api/tasks/:taskId with { userId } (null to clear)
Stage order changedPOST /api/tasks/:id/episodes with new order

If you open the modal and click Save without changing anything, no requests are made — the Save button is disabled when there are no changes.

Using the template​

Click Use Template to load the global Assignment Template and merge it into the current episode state:

  • Roles already in the episode are kept as-is
  • Roles from the template that are missing are added (without a user assigned)
  • Stage ordering from the template is applied to new roles

Stage management​

ActionHow
Add a stageClick Add Stage at the bottom
Add a role to a stageClick Add Role inside a stage, pick from the roles list
Move a role up one stageClick the ↑ arrow on the role
Move a role down one stageClick the ↓ arrow on the role
Remove a roleClick the × button on the role

Locked episodes​

When an episode is locked (completed or paused status), the modal opens in read-only mode — all controls are disabled and the Save button is hidden.