Sub-organisations

Look up the institute's sub-organisations (partner organisations / centres — call them by the institute's own term from whoami). Read-only. Pick an `action`:
- list (query?): every sub-org with its admin, plan status, seats used / total and invite code. When several match a name, list them and ask which one.
- get (sub_org_id): its courses (batches), seats used per course against the cap, admins, the settings it was created with (admin roles, team roles, admin permissions, validity, payment option) and the admin's invite link.
- members (sub_org_id, query?, include_inactive?): its learners with their courses and status.
- create_options: what sub_org_edit(change='create') needs — the institute's payment options (with prices), payment gateways, the roles a sub-org admin can be given and the admin permissions. The courses come from courses(action='list').
- enroll_template: the CSV columns sub_org_enroll takes (with the institute's custom fields) as a header + sample row — hand it to the admin as a .csv file to fill in.

Create a sub-organisation, change its set-up, or give it its admin. Never deletes or deactivates a sub-org and never removes a course from it (dashboard only). Every change is two calls: action='preview' (checks everything, saves nothing, returns what will happen + a confirm_token valid 15 min) → show the admin and get a clear yes → action='apply' with the SAME arguments plus confirm_token. Pick `change`:
- create: name, courses [{course_id, batch_id? (when the course has several batches)}] (at least one), payment_option_id (from sub_orgs(action='create_options') — ASK which; never pick a price), member_count (learner seats per course — ASK), validity_in_days (ASK), admin_roles [role names the sub-org's admin gets — ASK], team_roles? [roles that admin may give their own team], admin_permissions? (FULL default | CREATE_COURSE), vendor? (payment gateway, when the institute has several and the option is paid). Returns the sub-org and the admin's invite link.
- update: sub_org_id + any of add_courses [{course_id, batch_id?}], member_count, validity_in_days, admin_roles, team_roles, admin_permissions. The preview shows before → after.
- add_admin: sub_org_id + admin {full_name, email, mobile_number?}: makes that person the sub-org's admin on all its courses (an account is created when the email has none). Only when the sub-org has no admin yet. Alternative: send the admin the invite link from sub_orgs(action='get').

Add learners to a sub-organisation — one, a list or a whole CSV — into its courses (all of them unless batch_ids narrows it). Adds LEARNERS only (the sub-org's admin is sub_org_edit(change='add_admin')) and never removes anyone. Steps: sub_orgs(action='list') → sub_orgs(action='get') for its courses and seats → preview → show the admin the outcome (who is added to which course, who is skipped and why, seats left, which emails go out) and get a clear yes → enroll with the SAME arguments plus confirm_token. Pick an `action`:
- preview (sub_org_id, csv and/or learners, batch_ids?, options): checks everything; nothing is saved. Returns the per-learner plan and a confirm_token (valid 15 min).
- enroll (same arguments + confirm_token): does it, learner by learner, and reports each one.
csv: the filled-in sub_orgs(action='enroll_template') as CSV text (header row first). learners: [{learner_id} (an existing learner, from learners(action='find')) | a row with the template columns {email, full_name, mobile_number?, …, custom_fields?: {label: value}}] (max 200 in total). batch_ids: some of the sub-org's course batch_ids (default: all).
options: {credentials_file: bool — a CSV of every added learner's username + password, delivered as a private download link valid 30 minutes — ASK the admin}. Login-details emails follow Course Settings ('Send credentials') and cannot be switched per upload; the preview says whether they go out and which automations run.