Units

A unit is a section within a program, sorted by ordinal.

list_units

List the units of a program, ordered by ordinal. RLS-scoped.

Inputs:

Arg	Type	Notes
program_id	uuid	required

Result: { "units": [ { "id", "program_id", "ordinal", "title_i18n" }, … ] }

create_unit

Add a unit to a program. Author-role only.

Inputs:

Arg	Type	Notes
program_id	uuid	Parent program.
ordinal?	int ≥ 0	Sort position (default 0).
title_i18n?	string | map	i18n map or bare string.

Result: { "success": true, "unit": { "id", "program_id", "ordinal", "title_i18n" } }

update_unit

Update a unit’s ordinal and/or title_i18n. Author-role only. Only provided fields change.

Inputs:

Arg	Type	Notes
unit_id	uuid	required
ordinal?	int ≥ 0
title_i18n?	string | map

Result: { "success": true, "unit": {…} }

delete_unit

Delete a unit. Cascades to its lessons and activities. Author-role only.

Inputs:

Arg	Type	Notes
unit_id	uuid	required

Result: { "success": true, "deleted": "<unit_id>" }