Raw schema
{
"type": "object",
"properties": {
"template": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Template id from list_templates, for example \"whatsapp\", \"imessage\" or \"chatgpt\"."
},
"participants": {
"description": "Display names of the other people in the chat, not the user. Use made-up or user-provided names. Ignored by AI chat templates.",
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
},
"me_name": {
"description": "Optional display name for the user's own messages. Defaults to \"You\".",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"messages": {
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "\"me\" for the user's messages, \"them\" for the other person, or one of the participant names in a group chat. In AI chat templates, \"me\" is the prompt and anything else is the assistant reply."
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Message text, up to 500 characters. Plain text; links are not accepted."
},
"time": {
"description": "Optional timestamp label shown on the message, for example \"9:41 AM\".",
"type": "string",
"maxLength": 12
}
},
"required": [
"from",
"text"
]
},
"description": "Conversation in order, 1 to 30 messages, at most 4000 characters in total."
},
"title": {
"description": "Optional scene title, for example \"Weekend plans\". Used as the group or conversation name when the template shows one.",
"type": "string",
"maxLength": 80
},
"theme": {
"description": "Optional light or dark appearance. Defaults to the template default.",
"type": "string",
"enum": [
"light",
"dark"
]
}
},
"required": [
"template",
"messages"
]
}