classes_add_course

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Zooza company id to operate against. Optional: if the user has exactly one company, the server defaults to it — you can omit this field. With multiple companies, you MUST specify which; get the id list from `whoami.available_companies[].id`. If the user hasn't indicated which company they mean, ask them before guessing."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Programme name as clients will see it. Required, non-empty."
    },
    "programme_kind": {
      "type": "string",
      "enum": [
        "one_off_event",
        "full_duration",
        "pay_as_you_go"
      ],
      "description": "Default 'full_duration'. 'one_off_event' = single occurrence — lecture, workshop, open day. 'full_duration' = clients book all sessions for the whole period (terms). 'pay_as_you_go' = enrol once, book sessions individually (drop-in)."
    },
    "audience": {
      "type": "string",
      "enum": [
        "groups",
        "individuals"
      ],
      "description": "Default 'groups'. 'individuals' = 1-to-1 programme. Capacity is a class-level concern; nothing is auto-set to 1 here."
    },
    "for_children": {
      "type": "boolean",
      "description": "Default false (deliberate deviation from the app's default of true). true adds a child profile to the booking form (auto-activates date-of-birth + child-name fields). Ask the user when the vertical suggests kids (baby swim, kids dance, …)."
    },
    "payment_collection": {
      "type": "string",
      "enum": [
        "one_off",
        "installments"
      ],
      "description": "full_duration only. Default 'one_off'."
    },
    "price_type": {
      "type": "string",
      "enum": [
        "course_fee",
        "membership"
      ],
      "description": "full_duration + installments only. Default 'course_fee'."
    },
    "total_price": {
      "type": "number",
      "minimum": 0,
      "description": "The whole price the client pays for the run — what operators normally quote (\"300 for the term\"). REQUIRED for one_off_event and for full_duration with one_off collection, and the RECOMMENDED input for full_duration with installments too. For instalments Zooza charges per session, so this total is stored on the programme and classes_commit_class divides it by the sessions you create — you do NOT need to know the session count now. Never send both this and unit_price."
    },
    "unit_price": {
      "type": "number",
      "minimum": 0,
      "description": "Price PER SESSION. Only use this when the operator quoted a per-session figure — for a price covering the whole run use total_price instead, which works for instalment programmes too and is the usual case. REQUIRED for pay_as_you_go. Never send both this and total_price."
    },
    "unit_price_is_per_session": {
      "type": "boolean",
      "description": "Only for instalment programmes, and only alongside unit_price. Asserts you ASKED the operator whether their figure is per session or for the whole run, and they said PER SESSION. \"Unit price\" / \"jednotkova cena\" is ambiguous in everyday speech — never assume it means per session."
    },
    "registration_fee": {
      "type": "number",
      "minimum": 0,
      "description": "Default 0."
    },
    "color": {
      "type": "string",
      "description": "Optional admin/calendar colour."
    },
    "allow_duplicate_name": {
      "type": "boolean",
      "description": "Default false. Set true ONLY after the user confirms they want a second programme with the same name."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}