add_image_from_url
ChatGPTDownload an image from a public URL and attach it to this case. Targets: cover replaces the case cover image; character replaces an existing character's avatar; chat attaches to an existing image or context-image chat (create that chat first, then pass its ID). To create an image from a description instead, use generate_image.
check_case_quality
ChatGPTStart an evidence-based quality review of the selected saved case: objectives, answerability, meaningful interactions, opening hook, emotional arc and difficulty. Returns ordered full chat payloads in pages, counts and a rubric for you to evaluate, not an automated verdict. Retrieve every page, then report findings with chat IDs and recommendations. Read-only; does not edit the case.
create_badge
ChatGPTCreate a new badge in this case study. Badges are used for branching logic and scoring. Returns the created badge with its ID. Operates only on the currently selected case.
create_case
ChatGPTCreate a new, empty LiveCase case and select it. Use this when the author wants to start something new rather than edit an existing case. The new case becomes the selected case, so you can start adding content straight away.
create_character
ChatGPTCreate a new character in this case study. Returns the created character with its ID. Operates only on the currently selected case.
create_characteristic
ChatGPTCreate a new characteristic (trait/metric) in this case study. Average characteristics require their scoring maximum in averageOutOf; sum characteristics are unbounded. Returns the created characteristic with its ID. Operates only on the currently selected case.
create_chat
ChatGPTCreate a validated chat in the current case. For an episode-type case, omit section_id because chats live directly on the series. For season/series cases, section_id must be the current episode ID (never a season ID). The server validates the type-specific data shape and referenced IDs, assigns nested IDs, and shifts following chats to preserve a unique contiguous order. Operates only on the currently selected case.
create_chats
ChatGPTCreate 1-100 validated chats in one call, in array order, with one save. All chats go into the same episode: omit section_id for episode cases; use an episode ID for season/series cases. Placement applies to the entire batch. If any chat or placement is invalid, nothing is saved. Uses the same type-specific validation, referenced IDs and nested ID generation as create_chat. Call lookup_chat_type for unfamiliar data shapes. Operates only on the currently selected case.
create_debrief
ChatGPTCreate a new debrief in this case study. Debriefs are post-session review/reflection items. Returns the created debrief with its ID. Operates only on the currently selected case.
create_section
ChatGPTCreate a new section in this case study. Returns the created section with its ID. Operates only on the currently selected case.
delete_badge
ChatGPTDelete a badge from this case study. This also removes the badge from any chats that reference it. Requires two calls: first without confirmed=true to get a confirmation prompt, then with confirmed=true to execute the deletion. Operates only on the currently selected case.
delete_character
ChatGPTDelete a character from this case study. Requires two calls: first without confirmed=true to get a confirmation prompt, then with confirmed=true to execute the deletion. Operates only on the currently selected case.
delete_characteristic
ChatGPTDelete a characteristic from this case study. This also removes it from any chat answers that reference it. Requires two calls: first without confirmed=true to get a confirmation prompt, then with confirmed=true to execute the deletion. Operates only on the currently selected case.
delete_chat
ChatGPTDelete a chat item from this case study. Requires two calls: first without confirmed=true to get a confirmation prompt, then with confirmed=true to execute the deletion. Operates only on the currently selected case.
delete_debrief
ChatGPTDelete a debrief from this case study. Requires two calls: first without confirmed=true to get a confirmation prompt, then with confirmed=true to execute the deletion. Operates only on the currently selected case.
delete_section
ChatGPTDelete a section from this case study. This also removes all chats within the section. Requires two calls: first without confirmed=true to get a confirmation prompt, then with confirmed=true to execute the deletion. Operates only on the currently selected case.
fetch
ChatGPTReturn the full content of the currently selected case. Call select_case first.
generate_image
ChatGPTGenerate and save an image directly to this case. Targets: cover replaces the case cover; character replaces an existing character avatar; chat attaches to an existing image/context-image chat. Character avatars default to photorealistic human portraits unless the author explicitly requests another style; fictional characters alone do not imply cartoons. Covers follow packaging guidelines: one thematic focal point, contextual background, cinematic/photographic style, no text/logos/charts, simple at 256x256, not a centered headshot. Honor explicit author style choices. For a new image chat, create the chat first and then pass its returned ID here. Operates only on the currently selected case.
get_active_case
ChatGPTReport which case is currently selected. Use this to re-orient if you are unsure which case you are editing.
get_authoring_guidance
ChatGPTRetrieve LiveCase best practices for visual assets (realistic character avatars and packaging-compliant covers), quality review, the suggested authoring process, pacing, character voices, chat-type selection, metadata, learner readiness, assessment, roleplay or teaching notes. For a new case, start with authoring-process; consult pacing and character-voices when outlining or drafting. The process is recommended, not mandatory; adapt to the author's request and existing work. Optionally retrieve the chosen accessible template's overview too. No selected case is required.
get_case_files
ChatGPTGet case files attached to this case study. Call with no arguments for a list, or with case_file_id to read a specific file's content. Operates only on the currently selected case.
get_faq
ChatGPTLook up frequently asked questions and answers for the authoring interface. Use this when the user asks a how-to question, needs help with a feature, or seems confused about something. Available topics: -authoring-faq, basics, content, characters, badges, characteristics, marketing-/-metadata, visibility-&-publishing, advanced. Use 'all' to get everything. Operates only on the currently selected case.
get_page_info
ChatGPTLook up a static page reference with the UI layout, editable fields, and available actions for a specific page in the authoring interface. It does not contain live session values or current counts. Use this at most once when the user asks about what's on a page, where a field is, or what they can do on a specific page. Available pages: (basics): Basics, content: Content, characters: Characters, badges: Badges, characteristics: Characteristics, marketing: Marketing / Metadata, host: Host Settings, debrief: Debrief, visibility: Visibility, publishing: Publishing, advanced: Advanced Options, files: Files, stats: Statistics, pricing: Pricing, peer-review: Peer Review, validity: Validity Check Operates only on the currently selected case.
get_series_badges
ChatGPTGet badges in this case study. Badges are used for branching logic and scoring. Call with no arguments for a list of all badges, or with badge_id for detailed info about a specific badge. Operates only on the currently selected case.
get_series_characteristics
ChatGPTGet characteristics and their scoring scales. Always read averageOutOf/scoreScale before assigning characteristic values to question answers. Call with no arguments for all characteristics or with characteristic_id for one. Operates only on the currently selected case.
get_series_characters
ChatGPTGet characters in this case study. Call with no arguments for a list of all characters, or with character_id for detailed info about a specific character. Operates only on the currently selected case.
get_series_chats
ChatGPTGet chat items in the active chat container. Omit section_id for episode-type cases, where chats live directly on the series. For season/series cases, pass the episode section ID. Optionally pass chat_id for full type-specific data. Operates only on the currently selected case.
get_series_debriefs
ChatGPTGet debriefs (post-section review/discussion items) in this case study. Call with no arguments for a list of all debriefs, or with debrief_id for detailed info about a specific debrief. Operates only on the currently selected case.
get_series_overview
ChatGPTGet the current case type, basics, complete marketing metadata, AI authoring guide, and content counts. Operates only on the currently selected case.
get_series_sections
ChatGPTGet sections (acts/chapters) of this case study. Call with no arguments for a list of all sections, or with section_id for detailed info about a specific section. Operates only on the currently selected case.
get_template
ChatGPTRetrieve an accessible LiveCase template's purpose and stage index. Then pass stage_id to retrieve that stage's full design guidance. Follow its template-specific structure and best practices. No selected case is required; this does not modify case content or apply a template automatically.
list_chat_types
ChatGPTList every available chat type with its purpose and when to use it. Choose by learning objective and story need, then use lookup_chat_type for the exact payload. Operates only on the currently selected case.
list_my_cases
ChatGPTList the LiveCase cases you can edit. Call this first if no case is selected yet, or when the author wants to switch cases.
list_templates
ChatGPTList LiveCase authoring templates available to the signed-in user, with their learning purposes. Use before choosing a design approach. No selected case is required; this does not create a case.
lookup_chat_type
ChatGPTReturn the complete, creatable payload reference and exact validated data schema for one chat type. Exact IDs and common names are accepted; for example, 'allocation' and 'allocated balance' resolve to question-allocated-balance. Call this before creating or updating a chat whose shape is not known. Operates only on the currently selected case.
search
ChatGPTSearch the cases you can edit by title. Returns ids usable with fetch or select_case.
search_docs
ChatGPTSearch the LiveCase platform documentation for help articles and guides. Operates only on the currently selected case.
select_case
ChatGPTPin the case to work on. Case-content tools operate on this case until select_case is called again. Reference tools such as get_template do not require a selected case. Call list_my_cases first if you do not have a case_id.
update_badge
ChatGPTUpdate an existing badge in this case study. Provide the badge_id and any fields to update. Operates only on the currently selected case.
update_character
ChatGPTUpdate an existing character in this case study. Provide the character_id and any fields to update. Operates only on the currently selected case.
update_characteristic
ChatGPTUpdate an existing characteristic in this case study. Provide the characteristic_id and any fields to update. Operates only on the currently selected case.
update_chat
ChatGPTUpdate a validated existing chat without losing untouched fields. data is the complete replacement type-specific payload. Reposition with position/after_chat_id/before_chat_id; following chats are reindexed. For episode-type cases section_id is omitted; for season/series it may move the chat to another episode. Operates only on the currently selected case.
update_debrief
ChatGPTUpdate an existing debrief in this case study. Provide the debrief_id and any fields to update. Operates only on the currently selected case.
update_section
ChatGPTUpdate an existing section in this case study. Provide the section_id and any fields to update. Operates only on the currently selected case.
update_series
ChatGPTUpdate case basics, marketing metadata for hosts and players, teaching notes, or AI authoring guidance. Only supplied fields change. Use generate_image separately to replace the cover image. Operates only on the currently selected case.
