assign_inventory_to_character
ChatGPTDress a part: record that a character wears or carries an inventory item. Costume work, so show:edit OR inventory:edit on the production is enough, plus write access to the item.
assign_inventory_to_scene
ChatGPTRecord that a scene uses an inventory item (the prop plot / scenic plot). Needs write access to the scene's production and to the item.
assign_inventory_to_show
ChatGPTPut an inventory item on a production's list (Costumes, Props, Sets or Tech, by its category). Needs show:edit and write access to the item. Refuses when the item's quantity is already fully allocated elsewhere unless allowShared is set.
create_announcement
ChatGPTPost an announcement to a production's team, visible in the app for the given number of days. No email is sent. Needs announcements:create.
create_cue
ChatGPTAdd a tech cue to a scene — lighting, sound, mic, fly, automation, spot, video or deck — at the end of that scene's cue list, as the Tech tab's Add Cue does. Give the script page (as read_script_page numbers it) and the line that calls it, and the cue is bound to that page of the current script; when that line appears on the page exactly once, the cue is also pinned in the margin beside it (otherwise it is listed on the page to be dragged into place). Leave cueNumber out to number it next in its type (LX 12, SQ 4…). Nobody is emailed. Needs cues:edit on the production.
create_event
ChatGPTAdd a rehearsal, performance, build or meeting to a production's calendar. Give either start (an instant) or allDayDate. Needs show:edit.
create_inventory_item
ChatGPTAdd a costume, prop, set piece or piece of equipment to the caller's inventory library, optionally assigning it to a production at the same time. Costs are decimal strings in the account's currency. Assigning to a show needs show:edit there.
create_note
ChatGPTAdd a rehearsal or department note to a production, optionally on a scene and tagging people. Give a script page (as read_script_page numbers it) to put the note on that page of the current script, where the Script tab shows it; add the script line the note is about and, when that line appears on the page exactly once, the note is pinned in the left margin beside it. Nobody is emailed. Needs the notes:create permission on the show.
create_scene
ChatGPTAdd a scene to a production. Needs show:edit.
create_task
ChatGPTCreate a task on a production, optionally assigned to a person on its roster. Nobody is emailed. Needs tasks:create.
fetch
ChatGPTFetch one record by the id a search returned (show:…, scene:…, person:…, item:…, note:…, event:…, task:…, file:…). A file is returned as its text, like read_file.
get_budget
ChatGPTA production's budgets (by department) and expenses. Empty when the caller's role has no budget access.
get_inventory_item
ChatGPTOne costume, prop, set piece or piece of equipment.
get_person
ChatGPTOne person's record, with the characters they play and the shows they are on. Pass showId to read them in the context of a production you share with them.
get_rehearsal_report
ChatGPTOne rehearsal report in full.
get_run_sheet
ChatGPTThe backstage run sheet: crew tracks and every preset, shift and strike duty, in running order.
get_scene
ChatGPTOne scene with the people and characters in it, the props/costumes/set pieces assigned to it, its cues and its notes.
get_scene_inventory
ChatGPTWhich inventory each scene of a production needs — the prop plot and scenic plot in one list.
get_show
ChatGPTA production's details, the caller's role and permissions on it, which features it has turned off, and counts of scenes, roster and upcoming events.
list_announcements
ChatGPTA production's announcements to its team. Current ones by default.
list_auditions
ChatGPTA production's auditions with session and registrant counts. Empty unless the caller's role may run casting.
list_characters
ChatGPTA production's characters with who plays and understudies each.
list_collaborators
ChatGPTWho holds an account with access to a production, and the role each one has.
list_cues
ChatGPTThe production's tech cues — lighting, sound, mic, fly, automation, spot, video, deck — in running order with the scene each belongs to.
list_events
ChatGPTRehearsals, performances and other calendar events, soonest first. Without showId: every production this account can open. Dates are ISO 8601 instants in UTC.
list_files
ChatGPTFiles on a production (scripts, music, designs, documents) that the caller may see, with a link to open each in CueCall. readable says whether read_file can return the contents as text.
list_inventory
ChatGPTCostumes, props, set pieces and equipment assigned to a production. Cost fields are present only for roles allowed to see them.
list_notes
ChatGPTRehearsal and department notes on a production. Performers see only notes that tag them; everyone else sees the show's notes.
list_organizations
ChatGPTThe theatre companies (organizations) this account belongs to.
list_people
ChatGPTEveryone on a production's roster — cast, crew, volunteers — with the contact details the caller's role may see.
list_rehearsal_reports
ChatGPTThe stage manager's rehearsal reports on a production. Empty unless the caller's role may read reports.
list_scenes
ChatGPTA production's scenes in running order with their readiness status.
list_shows
ChatGPTEvery production (show) this account can open, with the caller's role on each.
list_signup_sheets
ChatGPTVolunteer, food and set-build signup sheets on a production. Empty unless the caller's role may manage signups.
list_songs
ChatGPTThe production's musical numbers and cued sound effects, with the scene and the characters in each.
list_tasks
ChatGPTTasks on a production (or every production this account can open), with optional filters.
read_file
ChatGPTThe text of a production file the caller may open — a script or sides (PDF), a design brief or contact sheet (Word), notes, CSV, JSON. Audio, video and images are described, not returned. Long documents are clipped; raise maxChars to read further.
read_script_page
ChatGPTRead the production's script one or more pages at a time, as text lines in reading order, with the cues and notes already on each page. Pages are numbered as the PDF numbers them (page 1 is the first sheet), which may differ from the number printed on the page. Returns at most 10 pages per call; use nextPage to continue. Pair with create_cue and create_note to work through a script marking it up.
remove_inventory_from_character
ChatGPTRecord that a character no longer wears or carries an inventory item. Same permissions as assigning it.
remove_inventory_from_scene
ChatGPTRecord that a scene no longer uses an inventory item. The item stays on the production. Needs write access to the scene's production.
remove_inventory_from_show
ChatGPTTake an inventory item off a production, and off every scene of it. The item itself stays in the library. Needs inventory:edit on the show.
resolve_note
ChatGPTMark a note resolved (or reopen it). Needs show:edit on the production.
search
ChatGPTSearch across everything this account can open — productions, scenes, people, inventory, notes, events and tasks. Returns ids to pass to fetch.
submit_feedback
ChatGPTSend a bug report, feature request, improvement idea or other product feedback to the CueCall team, exactly as the in-app Send Feedback form does. Only use this when the person asks to send feedback. Write the description in their words, describe what they were doing and what happened, and leave out other people's contact details. The CueCall team reviews it, and a confirmation is emailed to the person's own account address. Limited to 10 submissions an hour.
update_cue
ChatGPTChange a cue's number, type, description, trigger, mics, characters, song, followspot operator, timing or notes, or move it to another script page. Only the fields given change; a nullable field set to null is cleared. Moving the cue to a page, or changing its trigger line while it is on one, re-pins it beside that line when the line appears on the page exactly once (and unpins it otherwise); page: null takes it off the script. Cues cannot be deleted here — do that on the Tech tab. Needs cues:edit on the production.
update_event
ChatGPTChange an event's title, type, location, description or time. Needs show:edit.
update_inventory_item
ChatGPTChange an item's name, category, status, quantity, location, condition, ownership or costs. Needs write access to the item (its owner, its company pool, or inventory:edit on a show it is assigned to).
update_note
ChatGPTChange a note's text, department or priority, or move it onto a script page (or off the script with page: null). Moving it to a page with a scriptLine pins it beside that line when the line appears there exactly once. Needs show:edit on the production.
update_scene
ChatGPTChange a scene's title, description, location or overall status. Needs show:edit.
update_task
ChatGPTChange a task's status, title, description, due date, priority or assignee. Needs tasks:edit.
whoami
ChatGPTThe CueCall account this connection acts as, with the productions it can open and the role held on each. Call this first to learn which show ids to use.