{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/nuance-labs/json-schema/nuance-labs-create-conversation-request-schema.json",
  "title": "CreateConversationRequest",
  "description": "The conversation to create.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/nuance-labs-openapi.yml#/components/schemas/CreateConversationRequest",
  "type": "object",
  "properties": {
    "timezone": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The person's IANA time zone, such as `Europe/London`, so the persona knows their local time."
    },
    "max_session_seconds": {
      "anyOf": [
        {
          "exclusiveMinimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "The longest the conversation may run, in seconds. Held to the service's maximum, which is also what it runs for when you leave this out. The `started` event's `seconds_remaining` says the limit it runs with."
    },
    "green_screen": {
      "default": false,
      "type": "boolean",
      "description": "The persona over solid green (`#00FF00`), so your page can key it out and draw it over its own background. Only where your deployment offers it; some personas can't be drawn over green, and a conversation that asks for it on one of them is refused."
    }
  }
}