@epilot/sdk 2.20.64 → 2.20.66

package/definitions/chat.json

@@ -1772,6 +1772,390 @@
         ]
       }
     },
+    "/v1/website-chats/{website_chat_id}/preview-grant": {
+      "parameters": [
+        {
+          "in": "path",
+          "name": "website_chat_id",
+          "required": true,
+          "schema": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      ],
+      "post": {
+        "tags": [
+          "Website Chats"
+        ],
+        "operationId": "createWebsiteChatPreviewGrant",
+        "description": "Issues a single-use grant for an Agent Builder preview of this Website Chat. Only callable from the 360 portal; the preview runs without allowed websites (also before any are added), is exempt from Website Chat analytics and ends after 15 minutes. The grant is exchanged at POST /v1/sessions within 60 seconds.",
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "design_id": {
+                    "type": "string",
+                    "format": "uuid",
+                    "nullable": true,
+                    "description": "Unsaved design to preview. Omit to keep the saved design; null previews the default design."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Preview grant",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "grant",
+                    "expires_in",
+                    "frame_origin",
+                    "website_chat"
+                  ],
+                  "properties": {
+                    "grant": {
+                      "type": "string",
+                      "description": "Single-use grant for POST /v1/sessions."
+                    },
+                    "expires_in": {
+                      "type": "integer",
+                      "description": "Seconds until the grant expires."
+                    },
+                    "frame_origin": {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    "website_chat": {
+                      "type": "object",
+                      "required": [
+                        "key",
+                        "organisationName",
+                        "assistantName",
+                        "defaultLocale",
+                        "locales",
+                        "login_methods"
+                      ],
+                      "properties": {
+                        "key": {
+                          "type": "string"
+                        },
+                        "organisationName": {
+                          "type": "string"
+                        },
+                        "assistantName": {
+                          "type": "string"
+                        },
+                        "defaultLocale": {
+                          "type": "string",
+                          "enum": [
+                            "en",
+                            "de"
+                          ]
+                        },
+                        "login_methods": {
+                          "type": "array",
+                          "description": "Login methods currently available to the customer.",
+                          "items": {
+                            "type": "string",
+                            "enum": [
+                              "email_code",
+                              "portal_login"
+                            ],
+                            "description": "How a customer can log in or verify themselves in the chat."
+                          }
+                        },
+                        "starters": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "description": "Starter questions of the assigned Agent Builder website agent, by locale. Absent when the agent has none; clients then show their own defaults.",
+                          "properties": {
+                            "de": {
+                              "type": "array",
+                              "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                              "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 120
+                              }
+                            },
+                            "en": {
+                              "type": "array",
+                              "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                              "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 120
+                              }
+                            }
+                          }
+                        },
+                        "actions": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "description": "Prototype Guided Actions offered by this Website Chat.",
+                          "properties": {
+                            "meter_reading": {
+                              "type": "boolean"
+                            },
+                            "meter_reading_journey_id": {
+                              "type": "string",
+                              "format": "uuid"
+                            }
+                          }
+                        },
+                        "design": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "id": {
+                              "type": "string",
+                              "format": "uuid"
+                            },
+                            "last_modified_at": {
+                              "type": "string",
+                              "maxLength": 200
+                            },
+                            "style": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "palette": {
+                                  "type": "object",
+                                  "additionalProperties": false,
+                                  "properties": {
+                                    "primary": {
+                                      "type": "string",
+                                      "maxLength": 200
+                                    },
+                                    "background": {
+                                      "type": "string",
+                                      "maxLength": 200
+                                    }
+                                  }
+                                },
+                                "typography": {
+                                  "type": "object",
+                                  "additionalProperties": false,
+                                  "properties": {
+                                    "font": {
+                                      "type": "object",
+                                      "additionalProperties": false,
+                                      "properties": {
+                                        "font_family": {
+                                          "type": "string",
+                                          "maxLength": 200
+                                        }
+                                      }
+                                    }
+                                  }
+                                },
+                                "shape": {
+                                  "type": "object",
+                                  "additionalProperties": false,
+                                  "properties": {
+                                    "border_radius": {
+                                      "type": "number",
+                                      "minimum": 0,
+                                      "maximum": 100
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            "spark_theme": {
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "accentColor": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "backgroundColor": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "fontBody": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "fontHeading": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "radius": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "scaling": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "spacing": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "appearance": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "neutralColor": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "styleVariant": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "labelPosition": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "inputStyle": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "inputColor": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "cardVariant": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "cardColor": {
+                                  "type": "string",
+                                  "maxLength": 200
+                                },
+                                "highContrast": {
+                                  "type": "boolean"
+                                }
+                              }
+                            }
+                          },
+                          "required": [
+                            "id"
+                          ]
+                        },
+                        "locales": {
+                          "type": "array",
+                          "description": "Languages the chat offers, default first: the assigned Agent Builder website agent's languages, or both for a legacy agent. Hide the language choice when there is one.",
+                          "items": {
+                            "type": "string",
+                            "enum": [
+                              "en",
+                              "de"
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid preview request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Not called from the 360 portal",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Website Chat not found in this organisation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many previews; try again later",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/website-chats/{website_chat_id}/configuration": {
       "get": {
         "operationId": "getPublicWebsiteChat",
@@ -1833,6 +2217,31 @@
                         "description": "How a customer can log in or verify themselves in the chat."
                       }
                     },
+                    "starters": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "description": "Starter questions of the assigned Agent Builder website agent, by locale. Absent when the agent has none; clients then show their own defaults.",
+                      "properties": {
+                        "de": {
+                          "type": "array",
+                          "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 120
+                          }
+                        },
+                        "en": {
+                          "type": "array",
+                          "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 120
+                          }
+                        }
+                      }
+                    },
                     "actions": {
                       "type": "object",
                       "additionalProperties": false,
@@ -1982,6 +2391,7 @@
                     },
                     "locales": {
                       "type": "array",
+                      "description": "Languages the chat offers, default first: the assigned Agent Builder website agent's languages, or both for a legacy agent. Hide the language choice when there is one.",
                       "items": {
                         "type": "string",
                         "enum": [
@@ -2250,6 +2660,31 @@
                             "description": "How a customer can log in or verify themselves in the chat."
                           }
                         },
+                        "starters": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "description": "Starter questions of the assigned Agent Builder website agent, by locale. Absent when the agent has none; clients then show their own defaults.",
+                          "properties": {
+                            "de": {
+                              "type": "array",
+                              "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                              "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 120
+                              }
+                            },
+                            "en": {
+                              "type": "array",
+                              "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                              "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 120
+                              }
+                            }
+                          }
+                        },
                         "actions": {
                           "type": "object",
                           "additionalProperties": false,
@@ -2399,6 +2834,7 @@
                         },
                         "locales": {
                           "type": "array",
+                          "description": "Languages the chat offers, default first: the assigned Agent Builder website agent's languages, or both for a legacy agent. Hide the language choice when there is one.",
                           "items": {
                             "type": "string",
                             "enum": [
@@ -2408,6 +2844,10 @@
                           }
                         }
                       }
+                    },
+                    "preview": {
+                      "type": "boolean",
+                      "description": "Agent Builder preview session; the frame only runs it inside the 360 portal."
                     }
                   }
                 }
@@ -3405,6 +3845,96 @@
         }
       }
     },
+    "/v1/login/portal/journey-token": {
+      "get": {
+        "operationId": "getChatPortalJourneyToken",
+        "security": [
+          {
+            "AnonymousSession": []
+          }
+        ],
+        "description": "Prototype. The portal ID token of this session's portal login, for an embedded Journey running in the Journey app's parent-auth mode, so the customer does not log in twice. Only for a valid portal login; the frame keeps it in memory and posts it only to the Journey origin.",
+        "responses": {
+          "200": {
+            "description": "Portal ID token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "id_token",
+                    "expires_at"
+                  ],
+                  "properties": {
+                    "id_token": {
+                      "type": "string"
+                    },
+                    "expires_at": {
+                      "type": "integer",
+                      "description": "Unix seconds"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "default": {
+            "description": "400 invalid input, 401 expired capability, 403 origin denied, 404 unpublished Website Chat, 409 conflict, 413 too large, 429 rate limit, or 503 unavailable.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "code"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "INVALID_VERIFICATION_CODE",
+                        "VERIFICATION_EXPIRED",
+                        "VERIFICATION_CONFLICT",
+                        "VERIFICATION_DISABLED",
+                        "VERIFICATION_UNAVAILABLE",
+                        "IDENTITY_CHANGED",
+                        "INVALID_REQUEST",
+                        "ORIGIN_DENIED",
+                        "NOT_FOUND",
+                        "INVALID_GRANT",
+                        "SESSION_EXPIRED",
+                        "RATE_LIMITED",
+                        "SESSION_LIMIT",
+                        "USAGE_LIMIT",
+                        "REQUEST_CONFLICT",
+                        "IN_PROGRESS",
+                        "UNAVAILABLE",
+                        "TEMPORARILY_UNAVAILABLE",
+                        "IDENTITY_REQUIRED",
+                        "ACTION_UNAVAILABLE",
+                        "ACTION_CONFLICT",
+                        "ACTION_TARGET_DENIED",
+                        "INVALID_LOGIN_CODE",
+                        "LOGIN_EXPIRED",
+                        "LOGIN_DISABLED",
+                        "LOGIN_UNAVAILABLE",
+                        "LOGIN_CONFLICT",
+                        "LOGIN_REJECTED"
+                      ]
+                    },
+                    "attempts_left": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Remaining code attempts; only with INVALID_LOGIN_CODE."
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/login/portal/start": {
       "post": {
         "operationId": "startChatPortalLogin",
@@ -4462,6 +4992,103 @@
         }
       }
     },
+    "/v1/actions/events": {
+      "post": {
+        "operationId": "reportChatActionEvent",
+        "security": [
+          {
+            "AnonymousSession": []
+          }
+        ],
+        "description": "Report what an embedded journey did, so the assistant can refer to it. Accepted only for a journey action this Website Chat offers. Browser input: the assistant is told it is not confirmed.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "action",
+                  "event"
+                ],
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z_]{0,59}$"
+                  },
+                  "event": {
+                    "type": "string",
+                    "enum": [
+                      "journey_submitted",
+                      "journey_closed"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "204": {
+            "description": "Recorded"
+          },
+          "default": {
+            "description": "400 invalid input, 401 expired capability, 403 origin denied, 404 unpublished Website Chat, 409 conflict, 413 too large, 429 rate limit, or 503 unavailable.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "code"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "INVALID_VERIFICATION_CODE",
+                        "VERIFICATION_EXPIRED",
+                        "VERIFICATION_CONFLICT",
+                        "VERIFICATION_DISABLED",
+                        "VERIFICATION_UNAVAILABLE",
+                        "IDENTITY_CHANGED",
+                        "INVALID_REQUEST",
+                        "ORIGIN_DENIED",
+                        "NOT_FOUND",
+                        "INVALID_GRANT",
+                        "SESSION_EXPIRED",
+                        "RATE_LIMITED",
+                        "SESSION_LIMIT",
+                        "USAGE_LIMIT",
+                        "REQUEST_CONFLICT",
+                        "IN_PROGRESS",
+                        "UNAVAILABLE",
+                        "TEMPORARILY_UNAVAILABLE",
+                        "IDENTITY_REQUIRED",
+                        "ACTION_UNAVAILABLE",
+                        "ACTION_CONFLICT",
+                        "ACTION_TARGET_DENIED",
+                        "INVALID_LOGIN_CODE",
+                        "LOGIN_EXPIRED",
+                        "LOGIN_DISABLED",
+                        "LOGIN_UNAVAILABLE",
+                        "LOGIN_CONFLICT",
+                        "LOGIN_REJECTED"
+                      ]
+                    },
+                    "attempts_left": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Remaining code attempts; only with INVALID_LOGIN_CODE."
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/actions/{action_id}/submit": {
       "post": {
         "operationId": "submitChatAction",
@@ -5984,6 +6611,265 @@
           }
         }
       },
+      "WebsiteChatPreviewGrantRequest": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "design_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true,
+            "description": "Unsaved design to preview. Omit to keep the saved design; null previews the default design."
+          }
+        }
+      },
+      "WebsiteChatPreviewGrant": {
+        "type": "object",
+        "required": [
+          "grant",
+          "expires_in",
+          "frame_origin",
+          "website_chat"
+        ],
+        "properties": {
+          "grant": {
+            "type": "string",
+            "description": "Single-use grant for POST /v1/sessions."
+          },
+          "expires_in": {
+            "type": "integer",
+            "description": "Seconds until the grant expires."
+          },
+          "frame_origin": {
+            "type": "string",
+            "format": "uri"
+          },
+          "website_chat": {
+            "type": "object",
+            "required": [
+              "key",
+              "organisationName",
+              "assistantName",
+              "defaultLocale",
+              "locales",
+              "login_methods"
+            ],
+            "properties": {
+              "key": {
+                "type": "string"
+              },
+              "organisationName": {
+                "type": "string"
+              },
+              "assistantName": {
+                "type": "string"
+              },
+              "defaultLocale": {
+                "type": "string",
+                "enum": [
+                  "en",
+                  "de"
+                ]
+              },
+              "login_methods": {
+                "type": "array",
+                "description": "Login methods currently available to the customer.",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "email_code",
+                    "portal_login"
+                  ],
+                  "description": "How a customer can log in or verify themselves in the chat."
+                }
+              },
+              "starters": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "Starter questions of the assigned Agent Builder website agent, by locale. Absent when the agent has none; clients then show their own defaults.",
+                "properties": {
+                  "de": {
+                    "type": "array",
+                    "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120
+                    }
+                  },
+                  "en": {
+                    "type": "array",
+                    "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120
+                    }
+                  }
+                }
+              },
+              "actions": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "Prototype Guided Actions offered by this Website Chat.",
+                "properties": {
+                  "meter_reading": {
+                    "type": "boolean"
+                  },
+                  "meter_reading_journey_id": {
+                    "type": "string",
+                    "format": "uuid"
+                  }
+                }
+              },
+              "design": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "format": "uuid"
+                  },
+                  "last_modified_at": {
+                    "type": "string",
+                    "maxLength": 200
+                  },
+                  "style": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "palette": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "properties": {
+                          "primary": {
+                            "type": "string",
+                            "maxLength": 200
+                          },
+                          "background": {
+                            "type": "string",
+                            "maxLength": 200
+                          }
+                        }
+                      },
+                      "typography": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "properties": {
+                          "font": {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "properties": {
+                              "font_family": {
+                                "type": "string",
+                                "maxLength": 200
+                              }
+                            }
+                          }
+                        }
+                      },
+                      "shape": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "properties": {
+                          "border_radius": {
+                            "type": "number",
+                            "minimum": 0,
+                            "maximum": 100
+                          }
+                        }
+                      }
+                    }
+                  },
+                  "spark_theme": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "accentColor": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "backgroundColor": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "fontBody": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "fontHeading": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "radius": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "scaling": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "spacing": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "appearance": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "neutralColor": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "styleVariant": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "labelPosition": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "inputStyle": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "inputColor": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "cardVariant": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "cardColor": {
+                        "type": "string",
+                        "maxLength": 200
+                      },
+                      "highContrast": {
+                        "type": "boolean"
+                      }
+                    }
+                  }
+                },
+                "required": [
+                  "id"
+                ]
+              },
+              "locales": {
+                "type": "array",
+                "description": "Languages the chat offers, default first: the assigned Agent Builder website agent's languages, or both for a legacy agent. Hide the language choice when there is one.",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "en",
+                    "de"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
       "Error": {
         "type": "object",
         "properties": {
@@ -6695,6 +7581,15 @@
           }
         }
       },
+      "StarterQuestions": {
+        "type": "array",
+        "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+        "items": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120
+        }
+      },
       "PublicWebsiteChat": {
         "type": "object",
         "required": [
@@ -6734,6 +7629,31 @@
               "description": "How a customer can log in or verify themselves in the chat."
             }
           },
+          "starters": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Starter questions of the assigned Agent Builder website agent, by locale. Absent when the agent has none; clients then show their own defaults.",
+            "properties": {
+              "de": {
+                "type": "array",
+                "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              },
+              "en": {
+                "type": "array",
+                "description": "At most six. (No maxItems, which generated clients turn into fixed-length tuples.)",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              }
+            }
+          },
           "actions": {
             "type": "object",
             "additionalProperties": false,
@@ -6883,6 +7803,7 @@
           },
           "locales": {
             "type": "array",
+            "description": "Languages the chat offers, default first: the assigned Agent Builder website agent's languages, or both for a legacy agent. Hide the language choice when there is one.",
             "items": {
               "type": "string",
               "enum": [