add_portrait
ChatGPTAdd a portrait to a character. Use import_upload for a ChatGPT file, or create_upload and PUT the local file first. The first portrait becomes the default.
create_automation
ChatGPTCreate a named automation for a campaign member. Read get_automation_options first. Saving can affect an open game screen immediately.
create_campaign
ChatGPTCreate a campaign owned by the signed-in user, subject to their ownership allowance. Player memberships do not count toward this allowance. If creation is refused, explain the returned error and do not retry until the relevant account state changes.
create_character
ChatGPTCreate a character in a campaign. npc defaults to true, for NPCs and monsters. hidden keeps a character off the player view, and dm_notes are private to the DM. A player who may create characters gets a player character linked to them.
create_condition
ChatGPTDefine a new condition in a campaign. Names are unique within a campaign. Apply it to a character with update_character.
create_map
ChatGPTAdd a map to a campaign. Use import_upload for a ChatGPT file, or create_upload and PUT the local file first. A new map starts fully covered by fog, and is not put on the table.
create_reveal
ChatGPTAdd a handout, image, video, or sound to a campaign's reveal pile. Use import_upload for a ChatGPT file, or create_upload and PUT the local file first. This does not show it to the table.
create_upload
ChatGPTOnly for assistants that can PUT a local file themselves, such as a coding agent on the user's computer. Not in ChatGPT: its sandbox cannot reach the upload URL, so use import_upload there. Start uploading a file, such as a portrait or a handout. Send its filename, content_type, byte_size, and checksum (the base64-encoded MD5 of the bytes). Then PUT the raw bytes to upload.url with exactly upload.headers, and pass signed_id as the file field of another tool. Up to 100 MB. A file that is never used is deleted after a day.
delete_automation
ChatGPTDelete an automation. This can change an open game screen and bring a retained rule within the member's rank limit.
get_automation_options
ChatGPTRead before writing automations. Returns manageable member IDs, the selected member's visual-editor condition schema, permitted effect targets, rank allowance and a complete JSON Logic authoring guide. Omit campaign_user_id to use your own membership.
get_campaign
ChatGPTRead a campaign the signed-in user can open: its name, and the fields this user is allowed to change.
get_character
ChatGPTRead a character the signed-in user can see: its conditions, and the fields this user is allowed to change.
get_condition_icon_guide
ChatGPTRead before authoring custom condition icons. Returns the SVG skill: safe markup, colour tones, examples, attribution and saving through condition tools.
import_upload
ChatGPTCopy a file from the ChatGPT conversation into DM Screen (up to 100 MB): one the user attached, or an image you generated. Pass the file itself as file; do not invent a URL or file ID. Then pass signed_id to add_portrait, create_reveal, create_map, or an update tool. This stores the file but does not attach it or put it on the table. Unused files are deleted after a day.
list_automations
ChatGPTList a member's automations in execution order, including rules retained beyond their rank limit. Use get_automation_options to discover manageable member IDs. Later matching portrait rules win.
list_campaigns
ChatGPTCampaigns the signed-in user can open.
list_characters
ChatGPTCharacters in a campaign that the signed-in user can see, with their conditions and the fields this user is allowed to change. Archived characters are left out unless scope is archived.
list_conditions
ChatGPTConditions defined in a campaign, such as Poisoned or Bloodied, with the fields the signed-in user is allowed to change. Search by name with q before creating one.
list_maps
ChatGPTA campaign's maps, with their grid settings, grid detection progress, and which map is on the table.
list_portraits
ChatGPTA character's portraits, such as a default look and a bloodied one, and which one is default or active.
list_reveals
ChatGPTHandouts, images, videos, and sounds in a campaign's reveal pile that the signed-in user can see.
reorder_automation
ChatGPTMove an automation to an existing 1-based position in its member's list. Changes execution priority and which rules fit the rank allowance.
update_automation
ChatGPTUpdate an automation; send only fields to change. Read get_automation_options for its member before changing conditions or effects.
update_campaign
ChatGPTChange campaign fields the signed-in user is allowed to save. Send only the fields to change.
update_character
ChatGPTChange character fields the signed-in user is allowed to save. Send only the fields to change.
update_condition
ChatGPTChange a condition's name, color, icon, or prompt. Send only the fields to change.
update_map
ChatGPTRename a map, change its grid or image position, or replace its image. Send only the fields to change.
update_portrait
ChatGPTRename a portrait, replace its image, or make it the default or active one. Send only the fields to change.