Alga PSA Project Status
Overview
MSPs run onboarding, migrations and hardware refreshes as Alga projects. A project lead wants to know which phases are done, which tasks are stuck, and what to tell the client. Every tool here is a read and none is admin-gated in Conduit; moving tasks, changing status or reassigning happens in Alga.
Key Concepts
- Project → phases → tasks. Phases and tasks are not paginated: one call returns them all.
- Task status columns:
alga_projects_task_status_mappings_listreturns the status columns a project uses, in board order, each with itsproject_status_mapping_id. Withphase_idyou get the phase's own columns, or the project's when the phase has none. Use it to turn a task's mapping ID into a readable status and to know which column is last (done). - Project status (the project as a whole) is a separate status list:
alga_statuses_listwithtypeproject.
Common Workflows
Status report for one project
- Find it:
alga_projects_listwithclient_idorsearch, thenalga_projects_get. alga_projects_phases_listwith theproject_id.alga_projects_task_status_mappings_listwith theproject_idand each phase'sphase_idto get that phase's column order and names (a phase without its own columns returns the project's).alga_projects_tasks_listwith theproject_id(addphase_idfor one phase). Bucket tasks by status column.- Per phase: tasks done vs total, tasks in progress, and tasks past their due date that
are not in the final column.
alga_projects_tasks_getfor detail on a blocker. - Optional effort view:
alga_time_entries_listwithwork_item_typeproject_task and the task'swork_item_id. - Write it up: overall state, per-phase progress, blockers with owners, next milestones. Keep internal remarks out of a client-facing version.
Portfolio view
alga_statuses_listwithtypeproject to get the status IDs.alga_projects_listwithstatusset to the in-progress status ID (a UUID), sorted byend_date. Page to the end.- Flag projects whose
end_datehas passed, then drill into the worst few with the single-project workflow.
Gotchas
- The
statusfilter onalga_projects_listmust be a status UUID fromalga_statuses_list. A status name is rejected. - Phase task lists can be large. If a result comes back truncated, filter by
phase_idinstead of pulling the whole project. - Task status meaning comes from the mapping list, not from the task row alone; fetch the mappings before labelling tasks.
- Owners are user IDs. Resolve them with
alga_users_getoralga_users_list.