Todo Properties

When you create a todo, it comes with a set of properties that define what it is, who it’s for, and when it needs to be done. Understanding these properties helps you keep your task list organized and ensures nothing falls through the cracks during production.

Todos have creation/context fields and a smaller set of mutable fields. The recorded owner or creator is the only person who can update or delete a todo.

Viewing Todo Properties

Select a track in the grid, then open the activity panel. The Todos widget displays all todos associated with that track.

Each todo appears as a compact card showing:

The todo content (truncated if long)
Completion status (checkbox)
Due date (if set)
Assignee name (if not assigned to you)

Click on any todo card to expand it and see all available properties. This is where you can view the full details and make changes.

Understanding Each Property

Content

The content field holds the actual task description. This is the only required field when creating a todo. Be specific — instead of “fix mix,” try “boost low-mids around 300Hz on lead vocal bus.”

Completion Status

The checkbox marks whether the task is done. Unchecking a completed todo restores it to your active list. This gives you a quick way to archive tasks without losing the record of what was done.

Assignee

By default, todos are assigned to their creator. A create or update can assign only the current user, the track owner, or a registered collaborator assigned to the todo’s track group.

Due Date

Set a deadline to keep your production on schedule. Click the date field and pick a day from the calendar. The due date appears on the todo card so you can see upcoming tasks at a glance.

Workflow Stage

workflow is an updateable todo field. Its available values and presentation are determined by the active workflow configuration.

Timecode

Timecode is optional context at creation. It is not a mutable todo property.

Track Assignment

track_id is optional creation context. When supplied, the service verifies scoped access to that track’s group before it creates the todo.

Comment Link

Todos can optionally link to a comment at creation. A failure to add that link does not prevent the todo record itself from being created.

Editing Todo Properties

Open the Todos widget and click on the todo you want to edit. In the expanded view, any editable field becomes interactive:

Change the content by clicking the text and typing
Toggle the completion checkbox when the task is done
Change the assignee using the dropdown menu
Pick a new due date from the calendar
Adjust the workflow stage to match your current focus Only completed, content, workflow, assigned_to, and due_date are updateable. timecode, track_id, and comment linking remain creation/context fields.

Who Can Edit What

Not everyone can modify every todo. The rules work like this:

You are its recorded owner or creator — you can edit its supported properties
You are only the assignee or another collaborator — you can view the todo, but assignment alone does not grant edit or delete access
Track access — you need scoped access to a track before creating a todo on it

These permissions keep task management clean on shared projects. The todo’s recorded owner or creator controls its mutable details.