@breign/client 1.0.101 → 1.0.102

package/dist/openapi.json

@@ -69,6 +69,9 @@
   }, {
     "description" : "Skills management endpoints",
     "name" : "skills"
+  }, {
+    "description" : "Scheduled task management endpoints",
+    "name" : "scheduled-tasks"
   } ],
   "paths" : {
     "/health" : {
@@ -1497,11 +1500,10 @@
             "type" : "string"
           }
         }, {
-          "description" : "Sort conversations by last activity (asc = oldest first, desc = most recent first)",
+          "description" : "Sort order for results",
           "in" : "query",
           "name" : "sortOrder",
           "schema" : {
-            "default" : "desc",
             "enum" : [ "asc", "desc" ],
             "type" : "string"
           }
@@ -1598,6 +1600,55 @@
         "tags" : [ "prompts" ]
       }
     },
+    "/agents/{agentId}/conversations/{conversationId}" : {
+      "get" : {
+        "description" : "Get a specific conversation by its ID for the given agent",
+        "operationId" : "getAgentConversationById",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "conversationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Chat"
+                }
+              }
+            },
+            "description" : "The conversation"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User doesn't have access to this agent"
+          },
+          "404" : {
+            "description" : "Conversation not found"
+          },
+          "500" : {
+            "description" : "Failed to get conversation"
+          }
+        },
+        "summary" : "Get a conversation by ID for an agent",
+        "tags" : [ "agent" ]
+      }
+    },
     "/agents/{agentId}/message-audio/{audioFileId}" : {
       "delete" : {
         "description" : "Removes the audio chunk from the message in the database and deletes the file from object storage.\n",
@@ -1747,10 +1798,9 @@
         "tags" : [ "agent" ]
       }
     },
-    "/agents/{agentId}/apps" : {
+    "/agents/{agentId}/scheduled-tasks" : {
       "get" : {
-        "description" : "Get apps for agent id",
-        "operationId" : "getAppsForAgentId",
+        "operationId" : "listScheduledTasks",
         "parameters" : [ {
           "description" : "ID of the agent",
           "in" : "path",
@@ -1760,35 +1810,67 @@
             "format" : "uuid",
             "type" : "string"
           }
+        }, {
+          "description" : "Filter by task status",
+          "in" : "query",
+          "name" : "status",
+          "schema" : {
+            "enum" : [ "active", "paused", "done" ],
+            "type" : "string"
+          }
+        }, {
+          "description" : "Search query",
+          "in" : "query",
+          "name" : "q",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "schema" : {
+            "default" : 50,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Cursor for pagination (createdAt before this date)",
+          "in" : "query",
+          "name" : "before",
+          "schema" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
         } ],
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "items" : {
-                    "$ref" : "#/components/schemas/AppLight"
-                  },
-                  "type" : "array"
+                  "$ref" : "#/components/schemas/ScheduledTaskList"
                 }
               }
             },
-            "description" : "Apps retrieved successfully"
+            "description" : "List of scheduled tasks"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
           }
         },
-        "summary" : "Get apps for agent id",
-        "tags" : [ "app" ]
-      }
-    },
-    "/apps" : {
+        "summary" : "List scheduled tasks for an agent",
+        "tags" : [ "scheduledTasks" ]
+      },
       "post" : {
-        "description" : "Creates a new app",
-        "operationId" : "createApp",
+        "operationId" : "createScheduledTask",
         "parameters" : [ {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
           "schema" : {
+            "format" : "uuid",
             "type" : "string"
           }
         } ],
@@ -1796,7 +1878,7 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppCreateRequest"
+                "$ref" : "#/components/schemas/ScheduledTaskCreate"
               }
             }
           },
@@ -1807,25 +1889,45 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/ScheduledTask"
                 }
               }
             },
-            "description" : "App created successfully"
+            "description" : "Task created"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "422" : {
+            "description" : "Invalid schedule configuration"
           }
         },
-        "summary" : "Create an app",
-        "tags" : [ "app" ]
+        "summary" : "Create a scheduled task for an agent",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}" : {
+    "/agents/{agentId}/scheduled-tasks/{taskId}" : {
       "delete" : {
-        "description" : "Delete an app",
-        "operationId" : "deleteAppById",
+        "operationId" : "deleteScheduledTask",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -1833,19 +1935,36 @@
         } ],
         "responses" : {
           "204" : {
-            "description" : "App deleted successfully"
+            "description" : "Task deleted"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found"
           }
         },
-        "summary" : "Delete an app",
-        "tags" : [ "app" ]
+        "summary" : "Delete a scheduled task",
+        "tags" : [ "scheduledTasks" ]
       },
       "get" : {
-        "description" : "Get an app",
-        "operationId" : "getAppById",
+        "operationId" : "getScheduledTask",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -1856,23 +1975,40 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/ScheduledTask"
                 }
               }
             },
-            "description" : "App retrieved successfully"
+            "description" : "The scheduled task"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found"
           }
         },
-        "summary" : "Get an app",
-        "tags" : [ "app" ]
+        "summary" : "Get a scheduled task by ID",
+        "tags" : [ "scheduledTasks" ]
       },
-      "patch" : {
-        "description" : "Update an app",
-        "operationId" : "updateAppById",
+      "put" : {
+        "operationId" : "updateScheduledTask",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -1882,7 +2018,7 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppUpdateRequest"
+                "$ref" : "#/components/schemas/ScheduledTaskCreate"
               }
             }
           },
@@ -1893,27 +2029,48 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/ScheduledTask"
                 }
               }
             },
-            "description" : "App updated successfully"
+            "description" : "Task updated"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
           },
           "404" : {
-            "description" : "App not found"
+            "description" : "Task not found"
+          },
+          "422" : {
+            "description" : "Task completed or invalid schedule"
           }
         },
-        "summary" : "Update an app",
-        "tags" : [ "app" ]
+        "summary" : "Update a scheduled task",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/profile-picture" : {
-      "post" : {
-        "operationId" : "updateAppProfilePicture",
+    "/agents/{agentId}/scheduled-tasks/{taskId}/status" : {
+      "patch" : {
+        "operationId" : "toggleScheduledTaskStatus",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -1923,203 +2080,242 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/FileCreationRequest"
+                "$ref" : "#/components/schemas/ScheduledTaskStatusToggle"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "201" : {
+          "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/S3UploadBody"
+                  "$ref" : "#/components/schemas/ScheduledTaskStatusResponse"
                 }
               }
             },
-            "description" : "Profile picture updated successfully"
+            "description" : "Status updated"
+          },
+          "400" : {
+            "description" : "Invalid status value"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found"
+          },
+          "422" : {
+            "description" : "Task already completed"
           }
         },
-        "summary" : "Update profile picture for an app",
-        "tags" : [ "app" ]
+        "summary" : "Toggle scheduled task status (active/paused)",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/flows" : {
+    "/agents/{agentId}/scheduled-tasks/{taskId}/run" : {
       "post" : {
-        "description" : "Start a conversation with a flow.",
-        "operationId" : "createAppFlow",
+        "operationId" : "triggerScheduledTask",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
           "required" : true,
           "schema" : {
+            "format" : "uuid",
             "type" : "string"
           }
         }, {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
+          "required" : true,
           "schema" : {
             "type" : "string"
           }
-        }, {
-          "description" : "If true, the resource will not appear in history and will be deleted after a certain time.",
-          "in" : "query",
-          "name" : "ephemeral",
-          "required" : false,
-          "schema" : {
-            "type" : "boolean"
-          }
         } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/AppFlowCreateRequest"
-              }
-            }
-          },
-          "required" : true
-        },
         "responses" : {
-          "200" : {
+          "202" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/Flow"
+                  "$ref" : "#/components/schemas/ScheduledTaskManualRunResponse"
                 }
               }
             },
-            "description" : "App Flow created successfully"
+            "description" : "Run queued"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found"
           }
         },
-        "summary" : "Start a chat with a flow",
-        "tags" : [ "app" ]
+        "summary" : "Manually trigger a scheduled task run",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/chats" : {
-      "post" : {
-        "description" : "Initialize a chat",
-        "operationId" : "createAppChat",
+    "/agents/{agentId}/scheduled-tasks/{taskId}/runs" : {
+      "get" : {
+        "operationId" : "listScheduledTaskRuns",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
           "required" : true,
           "schema" : {
+            "format" : "uuid",
             "type" : "string"
           }
         }, {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
+          "required" : true,
           "schema" : {
             "type" : "string"
           }
         }, {
-          "description" : "If true, the resource will not appear in history and will be deleted after a certain time.",
           "in" : "query",
-          "name" : "ephemeral",
-          "required" : false,
+          "name" : "limit",
           "schema" : {
-            "type" : "boolean"
+            "default" : 20,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Cursor for pagination (createdAt before this date)",
+          "in" : "query",
+          "name" : "before",
+          "schema" : {
+            "format" : "date-time",
+            "type" : "string"
           }
         } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/AppChatCreateRequest"
-              }
-            }
-          },
-          "required" : true
-        },
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/AppChatCreateResponse"
+                  "$ref" : "#/components/schemas/ScheduledTaskRunList"
                 }
               }
             },
-            "description" : "App Chat created successfully"
+            "description" : "List of task runs with next scheduled run time"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found"
           }
         },
-        "summary" : "Initialize a chat",
-        "tags" : [ "app" ]
+        "summary" : "List runs for a scheduled task",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/chats/{chatId}" : {
-      "post" : {
-        "description" : "Submit a new message to a chat",
-        "operationId" : "submitNewMessageToChat",
+    "/agents/{agentId}/scheduled-tasks/{taskId}/runs/{runId}" : {
+      "get" : {
+        "operationId" : "getScheduledTaskRun",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
           "required" : true,
           "schema" : {
+            "format" : "uuid",
             "type" : "string"
           }
         }, {
-          "description" : "ID of the chat",
+          "description" : "ID of the scheduled task",
           "in" : "path",
-          "name" : "chatId",
+          "name" : "taskId",
           "required" : true,
           "schema" : {
             "type" : "string"
           }
         }, {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
+          "description" : "ID of the scheduled task run",
+          "in" : "path",
+          "name" : "runId",
+          "required" : true,
           "schema" : {
             "type" : "string"
           }
         } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/AppChatSubmitMessageRequest"
-              }
-            }
-          },
-          "required" : true
-        },
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/Flow"
+                  "$ref" : "#/components/schemas/ScheduledTaskRun"
                 }
               }
             },
-            "description" : "App Chat created successfully"
+            "description" : "The task run"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Run not found"
           }
         },
-        "summary" : "Submit a new message to a chat",
-        "tags" : [ "app" ]
+        "summary" : "Get a specific scheduled task run by ID",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/say" : {
-      "post" : {
-        "description" : "Make the app say something",
-        "operationId" : "saySomething",
+    "/agents/{agentId}/apps" : {
+      "get" : {
+        "description" : "Get apps for agent id",
+        "operationId" : "getAppsForAgentId",
         "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the agent",
           "in" : "path",
-          "name" : "appId",
+          "name" : "agentId",
           "required" : true,
           "schema" : {
+            "format" : "uuid",
             "type" : "string"
           }
-        }, {
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/AppLight"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Apps retrieved successfully"
+          }
+        },
+        "summary" : "Get apps for agent id",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps" : {
+      "post" : {
+        "description" : "Creates a new app",
+        "operationId" : "createApp",
+        "parameters" : [ {
           "description" : "Instance id",
           "in" : "query",
           "name" : "instanceId",
@@ -2131,32 +2327,32 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppChatSayRequest"
+                "$ref" : "#/components/schemas/AppCreateRequest"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "200" : {
+          "201" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/AppChatSayResponse"
+                  "$ref" : "#/components/schemas/App"
                 }
               }
             },
-            "description" : "App said something"
+            "description" : "App created successfully"
           }
         },
-        "summary" : "Make the app say something",
+        "summary" : "Create an app",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/messages" : {
-      "post" : {
-        "description" : "Submit new message",
-        "operationId" : "submitNewMessage",
+    "/apps/{appId}" : {
+      "delete" : {
+        "description" : "Delete an app",
+        "operationId" : "deleteAppById",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2165,10 +2361,50 @@
           "schema" : {
             "type" : "string"
           }
-        }, {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "App deleted successfully"
+          }
+        },
+        "summary" : "Delete an app",
+        "tags" : [ "app" ]
+      },
+      "get" : {
+        "description" : "Get an app",
+        "operationId" : "getAppById",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/App"
+                }
+              }
+            },
+            "description" : "App retrieved successfully"
+          }
+        },
+        "summary" : "Get an app",
+        "tags" : [ "app" ]
+      },
+      "patch" : {
+        "description" : "Update an app",
+        "operationId" : "updateAppById",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
           "schema" : {
             "type" : "string"
           }
@@ -2177,7 +2413,7 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppSubmitMessageRequest"
+                "$ref" : "#/components/schemas/AppUpdateRequest"
               }
             }
           },
@@ -2188,22 +2424,23 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "additionalProperties" : true,
-                  "type" : "object"
+                  "$ref" : "#/components/schemas/App"
                 }
               }
             },
-            "description" : "App message submitted successfully"
+            "description" : "App updated successfully"
+          },
+          "404" : {
+            "description" : "App not found"
           }
         },
-        "summary" : "Submit new message",
+        "summary" : "Update an app",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/status" : {
+    "/apps/{appId}/profile-picture" : {
       "post" : {
-        "description" : "Set app status",
-        "operationId" : "setStatus",
+        "operationId" : "updateAppProfilePicture",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2212,44 +2449,37 @@
           "schema" : {
             "type" : "string"
           }
-        }, {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
-          "schema" : {
-            "type" : "string"
-          }
         } ],
         "requestBody" : {
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppStatusRequest"
+                "$ref" : "#/components/schemas/FileCreationRequest"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "200" : {
+          "201" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/AppStatusResponse"
+                  "$ref" : "#/components/schemas/S3UploadBody"
                 }
               }
             },
-            "description" : "App status set successfully"
+            "description" : "Profile picture updated successfully"
           }
         },
-        "summary" : "Set app status",
+        "summary" : "Update profile picture for an app",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/probe" : {
-      "get" : {
-        "description" : "Probe the app",
-        "operationId" : "getAppProbe",
+    "/apps/{appId}/flows" : {
+      "post" : {
+        "description" : "Start a conversation with a flow.",
+        "operationId" : "createAppFlow",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2265,25 +2495,45 @@
           "schema" : {
             "type" : "string"
           }
-        } ],
-        "responses" : {
-          "200" : {
-            "content" : {
-              "application/json" : {
+        }, {
+          "description" : "If true, the resource will not appear in history and will be deleted after a certain time.",
+          "in" : "query",
+          "name" : "ephemeral",
+          "required" : false,
+          "schema" : {
+            "type" : "boolean"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppFlowCreateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/AppProbeResponse"
+                  "$ref" : "#/components/schemas/Flow"
                 }
               }
             },
-            "description" : "App probe retrieved successfully"
+            "description" : "App Flow created successfully"
           }
         },
-        "summary" : "Probe the app",
+        "summary" : "Start a chat with a flow",
         "tags" : [ "app" ]
-      },
+      }
+    },
+    "/apps/{appId}/chats" : {
       "post" : {
-        "description" : "Probe the app",
-        "operationId" : "probeApp",
+        "description" : "Initialize a chat",
+        "operationId" : "createAppChat",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2299,30 +2549,45 @@
           "schema" : {
             "type" : "string"
           }
+        }, {
+          "description" : "If true, the resource will not appear in history and will be deleted after a certain time.",
+          "in" : "query",
+          "name" : "ephemeral",
+          "required" : false,
+          "schema" : {
+            "type" : "boolean"
+          }
         } ],
         "requestBody" : {
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppProbeRequest"
+                "$ref" : "#/components/schemas/AppChatCreateRequest"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "204" : {
-            "description" : "App probed successfully"
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/AppChatCreateResponse"
+                }
+              }
+            },
+            "description" : "App Chat created successfully"
           }
         },
-        "summary" : "Probe the app",
+        "summary" : "Initialize a chat",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/probe/refresh" : {
+    "/apps/{appId}/chats/{chatId}" : {
       "post" : {
-        "description" : "Refresh the app probe",
-        "operationId" : "refreshAppProbe",
+        "description" : "Submit a new message to a chat",
+        "operationId" : "submitNewMessageToChat",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2332,30 +2597,9 @@
             "type" : "string"
           }
         }, {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "responses" : {
-          "204" : {
-            "description" : "App probe refreshed successfully"
-          }
-        },
-        "summary" : "Refresh the app probe",
-        "tags" : [ "app" ]
-      }
-    },
-    "/apps/{appId}/appConfiguration" : {
-      "delete" : {
-        "description" : "Delete app configuration",
-        "operationId" : "deleteAppConfiguration",
-        "parameters" : [ {
-          "description" : "ID of the app",
+          "description" : "ID of the chat",
           "in" : "path",
-          "name" : "appId",
+          "name" : "chatId",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -2368,17 +2612,36 @@
             "type" : "string"
           }
         } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppChatSubmitMessageRequest"
+              }
+            }
+          },
+          "required" : true
+        },
         "responses" : {
-          "204" : {
-            "description" : "App configuration deleted successfully"
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Flow"
+                }
+              }
+            },
+            "description" : "App Chat created successfully"
           }
         },
-        "summary" : "Delete app configuration",
+        "summary" : "Submit a new message to a chat",
         "tags" : [ "app" ]
-      },
-      "get" : {
-        "description" : "Get app configuration",
-        "operationId" : "getAppConfiguration",
+      }
+    },
+    "/apps/{appId}/say" : {
+      "post" : {
+        "description" : "Make the app say something",
+        "operationId" : "saySomething",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2395,27 +2658,36 @@
             "type" : "string"
           }
         } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppChatSayRequest"
+              }
+            }
+          },
+          "required" : true
+        },
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/AppConfiguration"
+                  "$ref" : "#/components/schemas/AppChatSayResponse"
                 }
               }
             },
-            "description" : "App configuration retrieved successfully"
-          },
-          "404" : {
-            "description" : "App configuration not found"
+            "description" : "App said something"
           }
         },
-        "summary" : "Get app configuration",
+        "summary" : "Make the app say something",
         "tags" : [ "app" ]
-      },
-      "put" : {
-        "description" : "Update app configuration",
-        "operationId" : "updateAppConfiguration",
+      }
+    },
+    "/apps/{appId}/messages" : {
+      "post" : {
+        "description" : "Submit new message",
+        "operationId" : "submitNewMessage",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2436,25 +2708,33 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppConfiguration"
+                "$ref" : "#/components/schemas/AppSubmitMessageRequest"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "204" : {
-            "description" : "App configuration updated successfully"
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "additionalProperties" : true,
+                  "type" : "object"
+                }
+              }
+            },
+            "description" : "App message submitted successfully"
           }
         },
-        "summary" : "Update app configuration",
+        "summary" : "Submit new message",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/appConfiguration/files/{type}" : {
+    "/apps/{appId}/status" : {
       "post" : {
-        "description" : "Add file to app configuration",
-        "operationId" : "addAppConfigurationFile",
+        "description" : "Set app status",
+        "operationId" : "setStatus",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2464,10 +2744,9 @@
             "type" : "string"
           }
         }, {
-          "description" : "Type of the file",
-          "in" : "path",
-          "name" : "type",
-          "required" : true,
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
           "schema" : {
             "type" : "string"
           }
@@ -2476,32 +2755,32 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/FileCreationRequest"
+                "$ref" : "#/components/schemas/AppStatusRequest"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "201" : {
+          "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/FileCreationResponse"
+                  "$ref" : "#/components/schemas/AppStatusResponse"
                 }
               }
             },
-            "description" : "File created successfully (return upload link)"
+            "description" : "App status set successfully"
           }
         },
-        "summary" : "Add file to app configuration",
+        "summary" : "Set app status",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/interrupts" : {
-      "post" : {
-        "description" : "Interrupt app",
-        "operationId" : "interruptApp",
+    "/apps/{appId}/probe" : {
+      "get" : {
+        "description" : "Probe the app",
+        "operationId" : "getAppProbe",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2519,31 +2798,23 @@
           }
         } ],
         "responses" : {
-          "201" : {
+          "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/BodyWithId"
+                  "$ref" : "#/components/schemas/AppProbeResponse"
                 }
               }
             },
-            "description" : "App interrupted"
-          },
-          "404" : {
-            "description" : "App not found"
-          },
-          "400" : {
-            "description" : "Invalid instance ID"
+            "description" : "App probe retrieved successfully"
           }
         },
-        "summary" : "Interrupt app",
+        "summary" : "Probe the app",
         "tags" : [ "app" ]
-      }
-    },
-    "/apps/{appId}/text-to-speech" : {
+      },
       "post" : {
-        "description" : "Text to speech",
-        "operationId" : "textToSpeech",
+        "description" : "Probe the app",
+        "operationId" : "probeApp",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2552,40 +2823,37 @@
           "schema" : {
             "type" : "string"
           }
+        }, {
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
+          "schema" : {
+            "type" : "string"
+          }
         } ],
         "requestBody" : {
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppTextToSpeechRequest"
+                "$ref" : "#/components/schemas/AppProbeRequest"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "201" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/AppTextToSpeechResponse"
-                }
-              }
-            },
-            "description" : "Text to speech"
-          },
-          "404" : {
-            "description" : "App not found"
+          "204" : {
+            "description" : "App probed successfully"
           }
         },
-        "summary" : "Text to speech",
+        "summary" : "Probe the app",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/instances" : {
-      "get" : {
-        "description" : "List persisted instances for an app (excludes ephemeral instances)",
-        "operationId" : "getInstancesForAppId",
+    "/apps/{appId}/probe/refresh" : {
+      "post" : {
+        "description" : "Refresh the app probe",
+        "operationId" : "refreshAppProbe",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2594,31 +2862,130 @@
           "schema" : {
             "type" : "string"
           }
-        } ],
+        }, {
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "App probe refreshed successfully"
+          }
+        },
+        "summary" : "Refresh the app probe",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/appConfiguration" : {
+      "delete" : {
+        "description" : "Delete app configuration",
+        "operationId" : "deleteAppConfiguration",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "App configuration deleted successfully"
+          }
+        },
+        "summary" : "Delete app configuration",
+        "tags" : [ "app" ]
+      },
+      "get" : {
+        "description" : "Get app configuration",
+        "operationId" : "getAppConfiguration",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "items" : {
-                    "$ref" : "#/components/schemas/AppInstanceListItem"
-                  },
-                  "type" : "array"
+                  "$ref" : "#/components/schemas/AppConfiguration"
                 }
               }
             },
-            "description" : "Instances retrieved successfully"
+            "description" : "App configuration retrieved successfully"
           },
           "404" : {
-            "description" : "App not found"
+            "description" : "App configuration not found"
           }
         },
-        "summary" : "List app instances",
+        "summary" : "Get app configuration",
         "tags" : [ "app" ]
       },
+      "put" : {
+        "description" : "Update app configuration",
+        "operationId" : "updateAppConfiguration",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppConfiguration"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "204" : {
+            "description" : "App configuration updated successfully"
+          }
+        },
+        "summary" : "Update app configuration",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/appConfiguration/files/{type}" : {
       "post" : {
-        "description" : "Create instance",
-        "operationId" : "createInstance",
+        "description" : "Add file to app configuration",
+        "operationId" : "addAppConfigurationFile",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2627,12 +2994,20 @@
           "schema" : {
             "type" : "string"
           }
+        }, {
+          "description" : "Type of the file",
+          "in" : "path",
+          "name" : "type",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
         } ],
         "requestBody" : {
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppInstanceCreateRequest"
+                "$ref" : "#/components/schemas/FileCreationRequest"
               }
             }
           },
@@ -2643,24 +3018,21 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/BodyWithId"
+                  "$ref" : "#/components/schemas/FileCreationResponse"
                 }
               }
             },
-            "description" : "Instance created"
-          },
-          "404" : {
-            "description" : "App not found"
+            "description" : "File created successfully (return upload link)"
           }
         },
-        "summary" : "Create instance",
+        "summary" : "Add file to app configuration",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/configuration/{property}" : {
-      "get" : {
-        "description" : "Get app configuration property",
-        "operationId" : "getAppConfigurationProperty",
+    "/apps/{appId}/interrupts" : {
+      "post" : {
+        "description" : "Interrupt app",
+        "operationId" : "interruptApp",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2670,37 +3042,39 @@
             "type" : "string"
           }
         }, {
-          "description" : "Property to retrieve",
-          "in" : "path",
-          "name" : "property",
-          "required" : true,
+          "description" : "Instance id",
+          "in" : "query",
+          "name" : "instanceId",
           "schema" : {
             "type" : "string"
           }
         } ],
         "responses" : {
-          "200" : {
+          "201" : {
             "content" : {
-              "text/plain" : {
+              "application/json" : {
                 "schema" : {
-                  "type" : "string"
+                  "$ref" : "#/components/schemas/BodyWithId"
                 }
               }
             },
-            "description" : "App configuration property"
+            "description" : "App interrupted"
           },
           "404" : {
-            "description" : "App not found or invalid property"
+            "description" : "App not found"
+          },
+          "400" : {
+            "description" : "Invalid instance ID"
           }
         },
-        "summary" : "Get app configuration property",
+        "summary" : "Interrupt app",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/animations" : {
+    "/apps/{appId}/text-to-speech" : {
       "post" : {
-        "description" : "Add an animation to an app",
-        "operationId" : "addAnimation",
+        "description" : "Text to speech",
+        "operationId" : "textToSpeech",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2714,7 +3088,7 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AnimationCreateRequest"
+                "$ref" : "#/components/schemas/AppTextToSpeechRequest"
               }
             }
           },
@@ -2725,24 +3099,24 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/BodyWithId"
+                  "$ref" : "#/components/schemas/AppTextToSpeechResponse"
                 }
               }
             },
-            "description" : "Animation added successfully"
+            "description" : "Text to speech"
           },
-          "409" : {
-            "description" : "Animation already exists"
+          "404" : {
+            "description" : "App not found"
           }
         },
-        "summary" : "Add an animation to an app",
+        "summary" : "Text to speech",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/animations/{animationId}" : {
-      "delete" : {
-        "description" : "Remove an animation from an app",
-        "operationId" : "removeAnimation",
+    "/apps/{appId}/instances" : {
+      "get" : {
+        "description" : "List persisted instances for an app (excludes ephemeral instances)",
+        "operationId" : "getInstancesForAppId",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2751,38 +3125,31 @@
           "schema" : {
             "type" : "string"
           }
-        }, {
-          "description" : "ID of the animation",
-          "in" : "path",
-          "name" : "animationId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
         } ],
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/BodyWithMessage"
+                  "items" : {
+                    "$ref" : "#/components/schemas/AppInstanceListItem"
+                  },
+                  "type" : "array"
                 }
               }
             },
-            "description" : "Animation removed successfully"
+            "description" : "Instances retrieved successfully"
           },
           "404" : {
-            "description" : "Animation not found"
+            "description" : "App not found"
           }
         },
-        "summary" : "Remove an animation from an app",
+        "summary" : "List app instances",
         "tags" : [ "app" ]
-      }
-    },
-    "/apps/{appId}/sequences" : {
+      },
       "post" : {
-        "description" : "Add a sequence to an app",
-        "operationId" : "addSequence",
+        "description" : "Create instance",
+        "operationId" : "createInstance",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2796,7 +3163,7 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/SequenceCreateRequest"
+                "$ref" : "#/components/schemas/AppInstanceCreateRequest"
               }
             }
           },
@@ -2811,20 +3178,20 @@
                 }
               }
             },
-            "description" : "Sequence added successfully"
+            "description" : "Instance created"
           },
-          "409" : {
-            "description" : "Sequence already exists"
+          "404" : {
+            "description" : "App not found"
           }
         },
-        "summary" : "Add a sequence to an app",
+        "summary" : "Create instance",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/sequences/{sequenceId}" : {
-      "delete" : {
-        "description" : "Remove a sequence from an app",
-        "operationId" : "removeSequence",
+    "/apps/{appId}/configuration/{property}" : {
+      "get" : {
+        "description" : "Get app configuration property",
+        "operationId" : "getAppConfigurationProperty",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -2834,9 +3201,9 @@
             "type" : "string"
           }
         }, {
-          "description" : "ID of the sequence",
+          "description" : "Property to retrieve",
           "in" : "path",
-          "name" : "sequenceId",
+          "name" : "property",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -2845,26 +3212,190 @@
         "responses" : {
           "200" : {
             "content" : {
-              "application/json" : {
+              "text/plain" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/BodyWithMessage"
+                  "type" : "string"
                 }
               }
             },
-            "description" : "Sequence removed successfully"
+            "description" : "App configuration property"
           },
           "404" : {
-            "description" : "Sequence not found"
+            "description" : "App not found or invalid property"
           }
         },
-        "summary" : "Remove a sequence from an app",
+        "summary" : "Get app configuration property",
         "tags" : [ "app" ]
       }
     },
-    "/apps/{appId}/conversations" : {
-      "get" : {
-        "description" : "Get paginated conversations for an app",
-        "operationId" : "getAppConversations",
+    "/apps/{appId}/animations" : {
+      "post" : {
+        "description" : "Add an animation to an app",
+        "operationId" : "addAnimation",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AnimationCreateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/BodyWithId"
+                }
+              }
+            },
+            "description" : "Animation added successfully"
+          },
+          "409" : {
+            "description" : "Animation already exists"
+          }
+        },
+        "summary" : "Add an animation to an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/animations/{animationId}" : {
+      "delete" : {
+        "description" : "Remove an animation from an app",
+        "operationId" : "removeAnimation",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the animation",
+          "in" : "path",
+          "name" : "animationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/BodyWithMessage"
+                }
+              }
+            },
+            "description" : "Animation removed successfully"
+          },
+          "404" : {
+            "description" : "Animation not found"
+          }
+        },
+        "summary" : "Remove an animation from an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/sequences" : {
+      "post" : {
+        "description" : "Add a sequence to an app",
+        "operationId" : "addSequence",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/SequenceCreateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/BodyWithId"
+                }
+              }
+            },
+            "description" : "Sequence added successfully"
+          },
+          "409" : {
+            "description" : "Sequence already exists"
+          }
+        },
+        "summary" : "Add a sequence to an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/sequences/{sequenceId}" : {
+      "delete" : {
+        "description" : "Remove a sequence from an app",
+        "operationId" : "removeSequence",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the sequence",
+          "in" : "path",
+          "name" : "sequenceId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/BodyWithMessage"
+                }
+              }
+            },
+            "description" : "Sequence removed successfully"
+          },
+          "404" : {
+            "description" : "Sequence not found"
+          }
+        },
+        "summary" : "Remove a sequence from an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/conversations" : {
+      "get" : {
+        "description" : "Get paginated conversations for an app",
+        "operationId" : "getAppConversations",
         "parameters" : [ {
           "description" : "ID of the app",
           "in" : "path",
@@ -3413,21 +3944,24 @@
     },
     "/configuration/upload-limits" : {
       "get" : {
-        "description" : "Returns max file size for conversation context attachments (from server configuration).",
+        "description" : "Retrieves file upload size limits for the application",
         "operationId" : "getUploadLimits",
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/UploadLimitsResponse"
+                  "$ref" : "#/components/schemas/getUploadLimits_200_response"
                 }
               }
             },
             "description" : "Upload limits"
+          },
+          "401" : {
+            "description" : "Unauthorized"
           }
         },
-        "summary" : "Get conversation upload limits",
+        "summary" : "Get upload limits",
         "tags" : [ "configuration" ]
       }
     },
@@ -8566,11 +9100,10 @@
         }
       },
       "sortOrder" : {
-        "description" : "Sort conversations by last activity (asc = oldest first, desc = most recent first)",
+        "description" : "Sort order for results",
         "in" : "query",
         "name" : "sortOrder",
         "schema" : {
-          "default" : "desc",
           "enum" : [ "asc", "desc" ],
           "type" : "string"
         }
@@ -8611,6 +9144,24 @@
           "type" : "string"
         }
       },
+      "taskIdPath" : {
+        "description" : "ID of the scheduled task",
+        "in" : "path",
+        "name" : "taskId",
+        "required" : true,
+        "schema" : {
+          "type" : "string"
+        }
+      },
+      "runIdPath" : {
+        "description" : "ID of the scheduled task run",
+        "in" : "path",
+        "name" : "runId",
+        "required" : true,
+        "schema" : {
+          "type" : "string"
+        }
+      },
       "appIdPath" : {
         "description" : "ID of the app",
         "in" : "path",
@@ -10087,6 +10638,11 @@
           "id" : {
             "type" : "string"
           },
+          "type" : {
+            "enum" : [ "chat", "task" ],
+            "nullable" : true,
+            "type" : "string"
+          },
           "title" : {
             "nullable" : true,
             "type" : "string"
@@ -10170,223 +10726,529 @@
           "flowNode" : {
             "type" : "string"
           },
-          "flowNodeRequirementsChecked" : {
-            "type" : "boolean"
+          "flowNodeRequirementsChecked" : {
+            "type" : "boolean"
+          },
+          "flowNodeRequirementsMet" : {
+            "type" : "boolean"
+          },
+          "flowNodeRequirementsCheckReason" : {
+            "type" : "string"
+          },
+          "flowNodeIterations" : {
+            "type" : "number"
+          },
+          "timestamp" : {
+            "type" : "string"
+          },
+          "actions" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ToolAction"
+            },
+            "type" : "array"
+          },
+          "attachments" : {
+            "items" : {
+              "$ref" : "#/components/schemas/FileAttachment"
+            },
+            "type" : "array"
+          },
+          "audio" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ChatMessage_audio_inner"
+            },
+            "type" : "array"
+          },
+          "stream" : {
+            "$ref" : "#/components/schemas/ChatMessage_stream"
+          },
+          "reasoning" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "usage" : {
+            "$ref" : "#/components/schemas/TokenUsage"
+          }
+        },
+        "required" : [ "content", "id", "role", "timestamp" ],
+        "type" : "object"
+      },
+      "ToolResults" : {
+        "properties" : {
+          "tool" : {
+            "$ref" : "#/components/schemas/ToolResults_tool"
+          },
+          "result" : {
+            "$ref" : "#/components/schemas/ToolResult"
+          },
+          "error" : {
+            "type" : "string"
+          },
+          "status" : {
+            "enum" : [ "ok", "error" ],
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
+      "ToolResult" : {
+        "properties" : {
+          "text" : {
+            "type" : "string"
+          },
+          "askConfirmation" : {
+            "type" : "boolean"
+          },
+          "confirmationLink" : {
+            "type" : "string"
+          },
+          "actions" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ToolAction"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "text" ],
+        "type" : "object"
+      },
+      "ToolAction" : {
+        "additionalProperties" : true,
+        "properties" : {
+          "code" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "code" ],
+        "type" : "object"
+      },
+      "Suggestion" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "text" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "text" ],
+        "type" : "object"
+      },
+      "FileAttachment" : {
+        "properties" : {
+          "type" : {
+            "$ref" : "#/components/schemas/AttachmentType"
+          },
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "mimeType" : {
+            "type" : "string"
+          },
+          "ext" : {
+            "type" : "string"
+          },
+          "size" : {
+            "type" : "number"
+          },
+          "key" : {
+            "type" : "string"
+          },
+          "url" : {
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/FileAttachmentStatus"
+          },
+          "processed" : {
+            "$ref" : "#/components/schemas/FileAttachment_processed"
+          }
+        },
+        "required" : [ "ext", "id", "key", "mimeType", "name", "size", "status", "type" ],
+        "type" : "object"
+      },
+      "TokenUsage" : {
+        "properties" : {
+          "inputTokens" : {
+            "type" : "number"
+          },
+          "outputTokens" : {
+            "type" : "number"
+          },
+          "reasoningTokens" : {
+            "type" : "number"
+          },
+          "totalTokens" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "inputTokens", "outputTokens", "reasoningTokens", "totalTokens" ],
+        "type" : "object"
+      },
+      "ChatContext" : {
+        "properties" : {
+          "attachments" : {
+            "items" : {
+              "$ref" : "#/components/schemas/FileAttachment"
+            },
+            "type" : "array"
+          },
+          "location" : {
+            "$ref" : "#/components/schemas/ChatContext_location"
+          },
+          "custom" : {
+            "additionalProperties" : true,
+            "type" : "object"
+          },
+          "openaiThreadId" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "attachments" ],
+        "type" : "object"
+      },
+      "PromptFlowCreateRequest" : {
+        "properties" : {
+          "lang" : {
+            "description" : "Language code (e.g., 'en', 'fr')",
+            "maxLength" : 2,
+            "type" : "string"
+          },
+          "customUserId" : {
+            "description" : "Optional custom user identifier",
+            "type" : "string"
+          },
+          "type" : {
+            "description" : "Type of conversation (defaults to 'chat')",
+            "enum" : [ "chat", "task" ],
+            "type" : "string"
+          }
+        },
+        "required" : [ "lang" ],
+        "type" : "object"
+      },
+      "MessageAudioDownloadUrl" : {
+        "properties" : {
+          "url" : {
+            "description" : "Presigned download URL for the message audio file",
+            "type" : "string"
+          }
+        },
+        "required" : [ "url" ],
+        "type" : "object"
+      },
+      "ConversationAttachmentDownloadUrl" : {
+        "properties" : {
+          "url" : {
+            "description" : "Presigned download URL or inline data URL for the image attachment",
+            "type" : "string"
+          }
+        },
+        "required" : [ "url" ],
+        "type" : "object"
+      },
+      "ScheduledTaskList" : {
+        "properties" : {
+          "tasks" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ScheduledTask"
+            },
+            "type" : "array"
+          },
+          "total" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "tasks", "total" ],
+        "type" : "object"
+      },
+      "ScheduledTask" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "organizationId" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "message" : {
+            "type" : "string"
+          },
+          "mode" : {
+            "enum" : [ "once", "recurring" ],
+            "type" : "string"
+          },
+          "status" : {
+            "enum" : [ "active", "paused", "done" ],
+            "type" : "string"
+          },
+          "schedule" : {
+            "$ref" : "#/components/schemas/TaskSchedule"
+          },
+          "cronExpression" : {
+            "type" : "string"
+          },
+          "timezone" : {
+            "type" : "string"
+          },
+          "lang" : {
+            "type" : "string"
+          },
+          "callbackUrl" : {
+            "type" : "string"
+          },
+          "runCount" : {
+            "type" : "integer"
+          },
+          "nextRunAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "endedAt" : {
+            "format" : "date-time",
+            "type" : "string"
           },
-          "flowNodeRequirementsMet" : {
-            "type" : "boolean"
+          "createdAt" : {
+            "format" : "date-time",
+            "type" : "string"
           },
-          "flowNodeRequirementsCheckReason" : {
+          "updatedAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "createdAt", "cronExpression", "id", "lang", "message", "mode", "organizationId", "runCount", "schedule", "status", "timezone", "updatedAt" ],
+        "type" : "object"
+      },
+      "TaskSchedule" : {
+        "properties" : {
+          "at" : {
             "type" : "string"
           },
-          "flowNodeIterations" : {
-            "type" : "number"
+          "freq" : {
+            "enum" : [ "minute", "interval", "daily", "weekly", "monthly", "cron" ],
+            "type" : "string"
           },
-          "timestamp" : {
+          "time" : {
+            "pattern" : "^([01]\\d|2[0-3]):[0-5]\\d$",
             "type" : "string"
           },
-          "actions" : {
+          "days" : {
             "items" : {
-              "$ref" : "#/components/schemas/ToolAction"
+              "maximum" : 6,
+              "minimum" : 0,
+              "type" : "integer"
             },
             "type" : "array"
           },
-          "attachments" : {
-            "items" : {
-              "$ref" : "#/components/schemas/FileAttachment"
-            },
-            "type" : "array"
+          "dom" : {
+            "maximum" : 31,
+            "minimum" : 1,
+            "type" : "integer"
           },
-          "audio" : {
-            "items" : {
-              "$ref" : "#/components/schemas/ChatMessage_audio_inner"
-            },
-            "type" : "array"
+          "interval" : {
+            "$ref" : "#/components/schemas/TaskScheduleInterval"
           },
-          "stream" : {
-            "$ref" : "#/components/schemas/ChatMessage_stream"
+          "cron" : {
+            "type" : "string"
           },
-          "reasoning" : {
-            "nullable" : true,
+          "start" : {
             "type" : "string"
           },
-          "usage" : {
-            "$ref" : "#/components/schemas/TokenUsage"
+          "end" : {
+            "$ref" : "#/components/schemas/TaskScheduleEnd"
           }
         },
-        "required" : [ "content", "id", "role", "timestamp" ],
         "type" : "object"
       },
-      "ToolResults" : {
+      "TaskScheduleInterval" : {
         "properties" : {
-          "tool" : {
-            "$ref" : "#/components/schemas/ToolResults_tool"
-          },
-          "result" : {
-            "$ref" : "#/components/schemas/ToolResult"
-          },
-          "error" : {
-            "type" : "string"
+          "n" : {
+            "minimum" : 1,
+            "type" : "integer"
           },
-          "status" : {
-            "enum" : [ "ok", "error" ],
+          "unit" : {
+            "enum" : [ "minutes", "hours", "days" ],
             "type" : "string"
           }
         },
+        "required" : [ "n", "unit" ],
         "type" : "object"
       },
-      "ToolResult" : {
+      "TaskScheduleEnd" : {
+        "oneOf" : [ {
+          "$ref" : "#/components/schemas/TaskScheduleEnd_oneOf"
+        }, {
+          "$ref" : "#/components/schemas/TaskScheduleEnd_oneOf_1"
+        }, {
+          "$ref" : "#/components/schemas/TaskScheduleEnd_oneOf_2"
+        } ],
+        "type" : "object"
+      },
+      "ScheduledTaskCreate" : {
         "properties" : {
-          "text" : {
+          "message" : {
+            "minLength" : 1,
             "type" : "string"
           },
-          "askConfirmation" : {
-            "type" : "boolean"
+          "mode" : {
+            "enum" : [ "once", "recurring" ],
+            "type" : "string"
           },
-          "confirmationLink" : {
+          "schedule" : {
+            "$ref" : "#/components/schemas/TaskSchedule"
+          },
+          "name" : {
             "type" : "string"
           },
-          "actions" : {
-            "items" : {
-              "$ref" : "#/components/schemas/ToolAction"
-            },
-            "type" : "array"
+          "timezone" : {
+            "type" : "string"
+          },
+          "callbackUrl" : {
+            "format" : "uri",
+            "type" : "string"
+          },
+          "lang" : {
+            "minLength" : 2,
+            "type" : "string"
           }
         },
-        "required" : [ "text" ],
+        "required" : [ "message", "mode", "schedule" ],
         "type" : "object"
       },
-      "ToolAction" : {
-        "additionalProperties" : true,
+      "ScheduledTaskStatusToggle" : {
         "properties" : {
-          "code" : {
+          "status" : {
+            "enum" : [ "active", "paused" ],
             "type" : "string"
           }
         },
-        "required" : [ "code" ],
+        "required" : [ "status" ],
         "type" : "object"
       },
-      "Suggestion" : {
+      "ScheduledTaskStatusResponse" : {
         "properties" : {
-          "id" : {
+          "status" : {
+            "enum" : [ "active", "paused" ],
             "type" : "string"
           },
-          "text" : {
+          "nextRunAt" : {
+            "format" : "date-time",
+            "nullable" : true,
             "type" : "string"
           }
         },
-        "required" : [ "id", "text" ],
+        "required" : [ "status" ],
         "type" : "object"
       },
-      "FileAttachment" : {
+      "ScheduledTaskManualRunResponse" : {
         "properties" : {
-          "type" : {
-            "$ref" : "#/components/schemas/AttachmentType"
+          "runId" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "runId" ],
+        "type" : "object"
+      },
+      "ScheduledTaskRunList" : {
+        "properties" : {
+          "runs" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ScheduledTaskRun"
+            },
+            "type" : "array"
           },
+          "nextRun" : {
+            "format" : "date-time",
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "nextRun", "runs" ],
+        "type" : "object"
+      },
+      "ScheduledTaskRun" : {
+        "properties" : {
           "id" : {
             "type" : "string"
           },
-          "name" : {
+          "taskId" : {
             "type" : "string"
           },
-          "mimeType" : {
+          "status" : {
+            "enum" : [ "pending", "running", "success", "error", "failed_permanently" ],
             "type" : "string"
           },
-          "ext" : {
+          "prompt" : {
             "type" : "string"
           },
-          "size" : {
-            "type" : "number"
-          },
-          "key" : {
+          "conversationId" : {
             "type" : "string"
           },
-          "url" : {
+          "triggeredAt" : {
+            "format" : "date-time",
             "type" : "string"
           },
-          "status" : {
-            "$ref" : "#/components/schemas/FileAttachmentStatus"
+          "startedAt" : {
+            "format" : "date-time",
+            "type" : "string"
           },
-          "processed" : {
-            "$ref" : "#/components/schemas/FileAttachment_processed"
-          }
-        },
-        "required" : [ "ext", "id", "key", "mimeType", "name", "size", "status", "type" ],
-        "type" : "object"
-      },
-      "TokenUsage" : {
-        "properties" : {
-          "inputTokens" : {
-            "type" : "number"
+          "finishedAt" : {
+            "format" : "date-time",
+            "type" : "string"
           },
-          "outputTokens" : {
-            "type" : "number"
+          "claimedAt" : {
+            "format" : "date-time",
+            "type" : "string"
           },
-          "reasoningTokens" : {
-            "type" : "number"
+          "retryCount" : {
+            "type" : "integer"
           },
-          "totalTokens" : {
-            "type" : "number"
-          }
-        },
-        "required" : [ "inputTokens", "outputTokens", "reasoningTokens", "totalTokens" ],
-        "type" : "object"
-      },
-      "ChatContext" : {
-        "properties" : {
-          "attachments" : {
+          "steps" : {
             "items" : {
-              "$ref" : "#/components/schemas/FileAttachment"
+              "$ref" : "#/components/schemas/RunStep"
             },
             "type" : "array"
           },
-          "location" : {
-            "$ref" : "#/components/schemas/ChatContext_location"
-          },
-          "custom" : {
-            "additionalProperties" : true,
-            "type" : "object"
-          },
-          "openaiThreadId" : {
+          "createdAt" : {
+            "format" : "date-time",
             "type" : "string"
           }
         },
-        "required" : [ "attachments" ],
+        "required" : [ "createdAt", "id", "prompt", "retryCount", "status", "steps", "taskId", "triggeredAt" ],
         "type" : "object"
       },
-      "PromptFlowCreateRequest" : {
+      "RunStep" : {
         "properties" : {
-          "lang" : {
-            "description" : "Language code (e.g., 'en', 'fr')",
-            "maxLength" : 2,
+          "type" : {
+            "enum" : [ "llm_call", "tool_call", "tool_result", "llm_response" ],
             "type" : "string"
           },
-          "customUserId" : {
-            "description" : "Optional custom user identifier",
+          "at" : {
+            "format" : "date-time",
             "type" : "string"
-          }
-        },
-        "required" : [ "lang" ],
-        "type" : "object"
-      },
-      "MessageAudioDownloadUrl" : {
-        "properties" : {
-          "url" : {
-            "description" : "Presigned download URL for the message audio file",
+          },
+          "tool" : {
             "type" : "string"
-          }
-        },
-        "required" : [ "url" ],
-        "type" : "object"
-      },
-      "ConversationAttachmentDownloadUrl" : {
-        "properties" : {
-          "url" : {
-            "description" : "Presigned download URL or inline data URL for the image attachment",
+          },
+          "input" : { },
+          "output" : { },
+          "tokens" : {
+            "type" : "integer"
+          },
+          "error" : {
             "type" : "string"
           }
         },
-        "required" : [ "url" ],
+        "required" : [ "at", "type" ],
         "type" : "object"
       },
       "AppLight" : {
@@ -11362,16 +12224,6 @@
         "required" : [ "currency", "price" ],
         "type" : "object"
       },
-      "UploadLimitsResponse" : {
-        "properties" : {
-          "conversationAttachmentMaxBytes" : {
-            "format" : "int64",
-            "type" : "integer"
-          }
-        },
-        "required" : [ "conversationAttachmentMaxBytes" ],
-        "type" : "object"
-      },
       "AudioFile" : {
         "properties" : {
           "id" : {
@@ -13087,6 +13939,16 @@
         "required" : [ "message" ],
         "type" : "object"
       },
+      "getUploadLimits_200_response" : {
+        "properties" : {
+          "conversationAttachmentMaxBytes" : {
+            "description" : "Maximum size in bytes for conversation attachments",
+            "type" : "number"
+          }
+        },
+        "required" : [ "conversationAttachmentMaxBytes" ],
+        "type" : "object"
+      },
       "updateConversationTitle_request" : {
         "properties" : {
           "title" : {
@@ -13501,6 +14363,43 @@
         "required" : [ "latitude", "longitude" ],
         "type" : "object"
       },
+      "TaskScheduleEnd_oneOf" : {
+        "properties" : {
+          "type" : {
+            "enum" : [ "never" ],
+            "type" : "string"
+          }
+        },
+        "required" : [ "type" ],
+        "type" : "object"
+      },
+      "TaskScheduleEnd_oneOf_1" : {
+        "properties" : {
+          "type" : {
+            "enum" : [ "count" ],
+            "type" : "string"
+          },
+          "count" : {
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        },
+        "required" : [ "count", "type" ],
+        "type" : "object"
+      },
+      "TaskScheduleEnd_oneOf_2" : {
+        "properties" : {
+          "type" : {
+            "enum" : [ "date" ],
+            "type" : "string"
+          },
+          "date" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "date", "type" ],
+        "type" : "object"
+      },
       "App_commands_inner" : {
         "properties" : {
           "name" : {