update_catalogue_directory

{
  "type": "object",
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "pattern": "^[a-z0-9]+(?:(?:-|_)+[a-z0-9]+)*$",
      "description": "Id of the directory to update (the catalogue URL segment). The id itself cannot be changed — create a new directory instead.",
      "example": "sales-coaching-en"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "description": "Display name of the directory.",
      "example": "Sales coaching"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Short description shown on the directory card."
    },
    "mojito_language_code": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "ar",
        "bg",
        "zh",
        "hr",
        "cs",
        "da",
        "nl",
        "en",
        "fil",
        "fi",
        "fr",
        "de",
        "el",
        "hi",
        "hu",
        "id",
        "it",
        "ja",
        "ko",
        "ms",
        "no",
        "pl",
        "pt",
        "br",
        "ro",
        "ru",
        "sk",
        "es",
        "sv",
        "ta",
        "th",
        "tr",
        "uk",
        "vi",
        null
      ],
      "description": "Language of the directory (one of the platform-languages.json codes). The catalogue groups directories by language.",
      "example": "en"
    },
    "visibility": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "public",
        "merchant_public",
        "merchant_invite",
        "merchant_unlisted",
        null
      ],
      "description": "Who can see the catalogue directory. Options — `public`: Shared across every merchant. Platform admins only — a merchant caller is rejected by row-level security. | `merchant_public`: Listed in the merchant's own catalogue — the normal choice. | `merchant_invite`: Owned by the merchant but not listed; reachable only for invited users. | `merchant_unlisted`: Owned by the merchant but not listed; reachable only via a direct link..",
      "example": "merchant_public"
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "draft",
        "active",
        "archived",
        null
      ],
      "description": "Lifecycle status of the catalogue directory. Options — `draft`: Not published — the directory exists but is not served to visitors. | `active`: Published and served in the catalogue. | `archived`: Retired — kept for reference but no longer served..",
      "example": "active"
    },
    "cover_image_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cover image URL shown on the directory card. null clears it."
    },
    "coach_plan": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "demo",
        "screening",
        "2nd",
        "3rd",
        "closing",
        "job-specific",
        "other",
        null
      ],
      "description": "Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit/null to leave it out of any plan. Options — `demo`: Demo session. | `screening`: Screening-interview practice. | `2nd`: Second-interview practice. | `3rd`: Third-interview practice. | `closing`: Closing / salary-negotiation practice. | `job-specific`: Job-specific coaching. | `other`: Anything that does not fit the other buckets..",
      "example": "screening"
    },
    "tags_sub": {
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ],
      "description": "Ids of the directories nested under this one, in display order. Replaces the whole list — send the full set, not just the additions. A referenced directory only appears if it exists and is visible to the viewer.",
      "example": [
        "sales-coaching-objections-en",
        "sales-coaching-closing-en"
      ]
    },
    "tags_interview_set_filter": {
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ],
      "description": "Tag filter selecting which coaching sessions this directory lists: a session appears when its own `tags` contain EVERY tag here (an AND, not an OR). Only `active` coaching/persona sessions with visibility `public` or `merchant_public` are listed. Set the matching tags on the session with the create-interview / job-interview-update `tags` field.",
      "example": [
        "sales",
        "objection-handling"
      ]
    },
    "content_md": {
      "type": [
        "string",
        "null"
      ],
      "description": "Markdown for the custom directory page. Sending null removes the custom page and restores the default grid; sending a string replaces the whole page. Directives, each ALONE on its own line: `[plan-progress]`, `[directory:<tag-id>]`, `[session:<interview-id>]`, `[sessions]`, `[sessions:<term>]`, `[sessions:filter=<term>,limit=<n>]`. Chips, callouts, cards, columns and buttons are available too — formatting guide: https://developer.jobmojito.com/cookbooks/format-content-with-markdown",
      "example": "## Sales coaching\n\nPick a session to practise with.\n\n[chip:6 sessions] [chip:Beginner,tone=accent]\n\n[sessions:filter=objection-handling,limit=6]\n"
    }
  },
  "required": [
    "id"
  ]
}