@breign/client 1.0.178 → 1.0.180

package/dist/openapi.json

@@ -3067,10 +3067,9 @@
         "tags" : [ "scheduledTasks" ]
       }
     },
-    "/agents/{agentId}/apps" : {
+    "/agents/{agentId}/scheduled-tasks/{taskId}/webhook" : {
       "get" : {
-        "description" : "Get apps for agent id",
-        "operationId" : "getAppsForAgentId",
+        "operationId" : "getScheduledTaskWebhook",
         "parameters" : [ {
           "description" : "ID of the agent",
           "in" : "path",
@@ -3080,34 +3079,55 @@
             "format" : "uuid",
             "type" : "string"
           }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
         } ],
         "responses" : {
-          "206" : {
+          "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "items" : {
-                    "$ref" : "#/components/schemas/AppLight"
-                  },
-                  "type" : "array"
+                  "$ref" : "#/components/schemas/WebhookEndpoint"
                 }
               }
             },
-            "description" : "Apps retrieved successfully"
+            "description" : "The webhook, without its secret"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found, or not triggered by a webhook"
           }
         },
-        "summary" : "Get apps for agent id",
-        "tags" : [ "app" ]
-      }
-    },
-    "/apps" : {
-      "post" : {
-        "description" : "Creates a new app",
-        "operationId" : "createApp",
+        "summary" : "The webhook of an automation triggered by a webhook",
+        "tags" : [ "scheduledTasks" ]
+      },
+      "patch" : {
+        "operationId" : "updateScheduledTaskWebhook",
         "parameters" : [ {
-          "description" : "Instance id",
-          "in" : "query",
-          "name" : "instanceId",
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
+          "required" : true,
           "schema" : {
             "type" : "string"
           }
@@ -3116,59 +3136,59 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AppCreateRequest"
+                "$ref" : "#/components/schemas/WebhookEndpointUpdate"
               }
             }
           },
           "required" : true
         },
         "responses" : {
-          "201" : {
+          "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/WebhookEndpoint"
                 }
               }
             },
-            "description" : "App created successfully"
+            "description" : "The updated webhook"
+          },
+          "400" : {
+            "description" : "Invalid body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden (another service user requires an organization admin)"
+          },
+          "404" : {
+            "description" : "Task not found, or not triggered by a webhook"
+          },
+          "422" : {
+            "description" : "The service user is not a member of the organization"
           }
         },
-        "summary" : "Create an app",
-        "tags" : [ "app" ]
+        "summary" : "Disable the webhook or change its service user",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}" : {
-      "delete" : {
-        "description" : "Delete an app by ID",
-        "operationId" : "deleteAppById",
+    "/agents/{agentId}/scheduled-tasks/{taskId}/webhook/rotate-secret" : {
+      "post" : {
+        "operationId" : "rotateScheduledTaskWebhookSecret",
         "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" : {
-          "204" : {
-            "description" : "App deleted successfully"
-          },
-          "404" : {
-            "description" : "App not found"
-          }
-        },
-        "summary" : "Delete an app",
-        "tags" : [ "app" ]
-      },
-      "get" : {
-        "description" : "Get an app",
-        "operationId" : "getAppById",
-        "parameters" : [ {
-          "description" : "ID of the app",
+        }, {
+          "description" : "ID of the scheduled task",
           "in" : "path",
-          "name" : "appId",
+          "name" : "taskId",
           "required" : true,
           "schema" : {
             "type" : "string"
@@ -3179,110 +3199,145 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/WebhookEndpoint"
                 }
               }
             },
-            "description" : "App retrieved successfully"
+            "description" : "The webhook, with its new secret (shown once)"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found, or not triggered by a webhook"
           }
         },
-        "summary" : "Get an app",
-        "tags" : [ "app" ]
-      },
-      "patch" : {
-        "description" : "Update an app",
-        "operationId" : "updateAppById",
+        "summary" : "Rotate the webhook secret (the old one stops working)",
+        "tags" : [ "scheduledTasks" ]
+      }
+    },
+    "/agents/{agentId}/scheduled-tasks/{taskId}/webhook/regenerate-url" : {
+      "post" : {
+        "operationId" : "regenerateScheduledTaskWebhookUrl",
         "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"
           }
         } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/AppUpdateRequest"
-              }
-            }
-          },
-          "required" : true
-        },
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/WebhookEndpoint"
                 }
               }
             },
-            "description" : "App updated successfully"
+            "description" : "The webhook at its new URL"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
           },
           "404" : {
-            "description" : "App not found"
+            "description" : "Task not found, or not triggered by a webhook"
           }
         },
-        "summary" : "Update an app",
-        "tags" : [ "app" ]
-      },
-      "put" : {
-        "description" : "Replace an app's full configuration. Contrairement au PATCH, ce corps exige `name`, `agentId`, `streamingEnabled`, `voiceProvider`, `voiceId` et `voiceModelId`, et n'accepte ni `disableFillers`, ni `favoriteOutfit`, ni `ephemeralInstances`.",
-        "operationId" : "replaceAppById",
+        "summary" : "Give the webhook a new URL (the old one answers 404)",
+        "tags" : [ "scheduledTasks" ]
+      }
+    },
+    "/agents/{agentId}/scheduled-tasks/{taskId}/webhook/events" : {
+      "get" : {
+        "operationId" : "listScheduledTaskWebhookEvents",
         "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"
           }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "default" : 20,
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
         } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/AppReplaceRequest"
-              }
-            }
-          },
-          "required" : true
-        },
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/App"
+                  "$ref" : "#/components/schemas/WebhookEventList"
                 }
               }
             },
-            "description" : "App replaced successfully"
+            "description" : "The latest calls, most recent first"
           },
-          "400" : {
-            "description" : "Invalid request body"
+          "401" : {
+            "description" : "Unauthorized"
           },
-          "404" : {
-            "description" : "App not found"
+          "403" : {
+            "description" : "Forbidden"
           },
-          "500" : {
-            "description" : "APP_UPDATE_FAILED — l'app est introuvable après écriture"
+          "404" : {
+            "description" : "Task not found, or not triggered by a webhook"
           }
         },
-        "summary" : "Replace an app",
-        "tags" : [ "app" ]
+        "summary" : "The latest calls received on the webhook",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/profile-picture" : {
+    "/agents/{agentId}/scheduled-tasks/{taskId}/webhook/test" : {
       "post" : {
-        "operationId" : "updateAppProfilePicture",
+        "description" : "The call goes through the same ingestion as a real one, and the agent runs for real.",
+        "operationId" : "testScheduledTaskWebhook",
         "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"
@@ -3292,30 +3347,295 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/FileCreationRequest"
+                "$ref" : "#/components/schemas/WebhookTestRequest"
               }
             }
           },
-          "required" : true
+          "required" : false
         },
         "responses" : {
-          "201" : {
+          "202" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/S3UploadBody"
+                  "$ref" : "#/components/schemas/WebhookTestResponse"
                 }
               }
             },
-            "description" : "Profile picture updated successfully"
+            "description" : "The test call is queued"
+          },
+          "400" : {
+            "description" : "Invalid body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Task not found, or not triggered by a webhook"
+          },
+          "422" : {
+            "description" : "The webhook or the automation is not active"
+          },
+          "429" : {
+            "description" : "Too many calls this minute"
           }
         },
-        "summary" : "Update profile picture for an app",
-        "tags" : [ "app" ]
+        "summary" : "Send a test call to the webhook, signed by the server",
+        "tags" : [ "scheduledTasks" ]
       }
     },
-    "/apps/{appId}/flows" : {
-      "post" : {
+    "/agents/{agentId}/apps" : {
+      "get" : {
+        "description" : "Get apps for agent id",
+        "operationId" : "getAppsForAgentId",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "206" : {
+            "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",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppCreateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/App"
+                }
+              }
+            },
+            "description" : "App created successfully"
+          }
+        },
+        "summary" : "Create an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}" : {
+      "delete" : {
+        "description" : "Delete an app by ID",
+        "operationId" : "deleteAppById",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "App deleted successfully"
+          },
+          "404" : {
+            "description" : "App not found"
+          }
+        },
+        "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"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppUpdateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/App"
+                }
+              }
+            },
+            "description" : "App updated successfully"
+          },
+          "404" : {
+            "description" : "App not found"
+          }
+        },
+        "summary" : "Update an app",
+        "tags" : [ "app" ]
+      },
+      "put" : {
+        "description" : "Replace an app's full configuration. Contrairement au PATCH, ce corps exige `name`, `agentId`, `streamingEnabled`, `voiceProvider`, `voiceId` et `voiceModelId`, et n'accepte ni `disableFillers`, ni `favoriteOutfit`, ni `ephemeralInstances`.",
+        "operationId" : "replaceAppById",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AppReplaceRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/App"
+                }
+              }
+            },
+            "description" : "App replaced successfully"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "404" : {
+            "description" : "App not found"
+          },
+          "500" : {
+            "description" : "APP_UPDATE_FAILED — l'app est introuvable après écriture"
+          }
+        },
+        "summary" : "Replace an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/profile-picture" : {
+      "post" : {
+        "operationId" : "updateAppProfilePicture",
+        "parameters" : [ {
+          "description" : "ID of the app",
+          "in" : "path",
+          "name" : "appId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/FileCreationRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/S3UploadBody"
+                }
+              }
+            },
+            "description" : "Profile picture updated successfully"
+          }
+        },
+        "summary" : "Update profile picture for an app",
+        "tags" : [ "app" ]
+      }
+    },
+    "/apps/{appId}/flows" : {
+      "post" : {
         "description" : "Start a conversation with a flow.",
         "operationId" : "createAppFlow",
         "parameters" : [ {
@@ -19379,9 +19699,10 @@
         "tags" : [ "tickets" ]
       }
     },
-    "/organizations/{organizationId}/integrations/gitlab" : {
+    "/organizations/{organizationId}/automations" : {
       "get" : {
-        "operationId" : "listGitlabIntegrations",
+        "description" : "Every member of the organization can read them, as they can read its agents.",
+        "operationId" : "listOrganizationAutomations",
         "parameters" : [ {
           "description" : "ID of the organization",
           "in" : "path",
@@ -19390,11 +19711,186 @@
           "schema" : {
             "type" : "string"
           }
-        } ],
-        "responses" : {
-          "200" : {
-            "content" : {
-              "application/json" : {
+        }, {
+          "in" : "query",
+          "name" : "agentId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "trigger",
+          "required" : false,
+          "schema" : {
+            "$ref" : "#/components/schemas/AutomationTriggerKind"
+          }
+        }, {
+          "description" : "Comma-separated statuses among active, paused, done (default active,paused).",
+          "in" : "query",
+          "name" : "status",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "q",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "default" : 50,
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "in" : "query",
+          "name" : "offset",
+          "required" : false,
+          "schema" : {
+            "default" : 0,
+            "minimum" : 0,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/AutomationList"
+                }
+              }
+            },
+            "description" : "The automations, newest first, with their key figures"
+          },
+          "400" : {
+            "description" : "Invalid query"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Not a member of the organization"
+          },
+          "404" : {
+            "description" : "Agent not in the organization"
+          }
+        },
+        "summary" : "The automations of the organization, or of one of its agents",
+        "tags" : [ "scheduledTasks" ]
+      }
+    },
+    "/organizations/{organizationId}/automation-runs" : {
+      "get" : {
+        "description" : "Most recent first. Every member of the organization can read them.",
+        "operationId" : "listOrganizationAutomationRuns",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "agentId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "taskId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "trigger",
+          "required" : false,
+          "schema" : {
+            "$ref" : "#/components/schemas/AutomationTriggerKind"
+          }
+        }, {
+          "in" : "query",
+          "name" : "status",
+          "required" : false,
+          "schema" : {
+            "$ref" : "#/components/schemas/AutomationRunOutcome"
+          }
+        }, {
+          "in" : "query",
+          "name" : "before",
+          "required" : false,
+          "schema" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "default" : 30,
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/AutomationRunList"
+                }
+              }
+            },
+            "description" : "The runs, with what triggered them and what became of their result"
+          },
+          "400" : {
+            "description" : "Invalid query"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Not a member of the organization"
+          },
+          "404" : {
+            "description" : "Agent not in the organization"
+          }
+        },
+        "summary" : "The runs of the automations of the organization, or of one of its agents",
+        "tags" : [ "scheduledTasks" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab" : {
+      "get" : {
+        "operationId" : "listGitlabIntegrations",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
                 "schema" : {
                   "items" : {
                     "$ref" : "#/components/schemas/GitlabIntegration"
@@ -23440,12 +23936,15 @@
             "allOf" : [ {
               "$ref" : "#/components/schemas/TaskSchedule"
             } ],
-            "description" : "null for an automation triggered by an event.",
+            "description" : "null for an automation triggered by an event or a webhook.",
             "nullable" : true
           },
           "trigger" : {
             "$ref" : "#/components/schemas/TaskTrigger"
           },
+          "webhook" : {
+            "$ref" : "#/components/schemas/WebhookEndpoint"
+          },
           "cronExpression" : {
             "type" : "string"
           },
@@ -23547,10 +24046,14 @@
         "type" : "object"
       },
       "TaskTrigger" : {
-        "description" : "What starts the automation. `schedule` (default): its schedule. `event`: a mention of one of the bot accounts in GitLab, in the given kinds of objects and projects (empty: all projects; `groupe/projet` or `groupe/*`).",
+        "description" : "What starts the automation. `schedule` (default): its schedule. `event`: a mention of one of the bot accounts in GitLab, in the given kinds of objects and projects (empty: all projects; `groupe/projet` or `groupe/*`). `webhook`: a call to its webhook (see `ScheduledTask.webhook`); the result goes to `callbackUrl`.",
         "properties" : {
           "type" : {
-            "enum" : [ "schedule", "event" ],
+            "enum" : [ "schedule", "event", "webhook" ],
+            "type" : "string"
+          },
+          "runAsUserId" : {
+            "description" : "`webhook` only, on create or update: the member the conversations run as (default: the caller; another member requires an organization admin). Not stored on the task.",
             "type" : "string"
           },
           "source" : {
@@ -23584,7 +24087,7 @@
         "type" : "object"
       },
       "ScheduledTaskCreate" : {
-        "description" : "`schedule` is required unless `trigger.type` is `event` (then `mode` must be `recurring`).",
+        "description" : "`schedule` is required unless `trigger.type` is `event` or `webhook` (then `mode` must be `recurring`). A `webhook` trigger creates the webhook, returned in `webhook` with its secret (shown once).",
         "properties" : {
           "message" : {
             "minLength" : 1,
@@ -23755,15 +24258,31 @@
         "type" : "object"
       },
       "ScheduledTaskRunTrigger" : {
-        "description" : "The GitLab mention that triggered a run.",
+        "description" : "The external event that triggered a run: a GitLab mention (`source: gitlab`, GitLab fields set) or a webhook call (`source: webhook`: `thread`, `contentType`, `payload`).",
         "properties" : {
           "eventId" : {
             "type" : "string"
           },
           "source" : {
-            "enum" : [ "gitlab" ],
+            "enum" : [ "gitlab", "webhook" ],
+            "type" : "string"
+          },
+          "thread" : {
+            "description" : "webhook only — the `X-Breign-Thread` of the call.",
+            "nullable" : true,
             "type" : "string"
           },
+          "contentType" : {
+            "description" : "webhook only.",
+            "type" : "string"
+          },
+          "payload" : {
+            "description" : "webhook only — the body received (untrusted caller data), or its start as text."
+          },
+          "payloadTruncated" : {
+            "description" : "webhook only.",
+            "type" : "boolean"
+          },
           "status" : {
             "$ref" : "#/components/schemas/ExternalEventStatus"
           },
@@ -23820,75 +24339,206 @@
             "type" : "string"
           }
         },
-        "required" : [ "author", "body", "botUsername", "conversationId", "eventId", "noteUrl", "projectPath", "receivedAt", "replyUrl", "routing", "source", "status", "targetIid", "targetTitle", "targetType", "targetUrl" ],
+        "required" : [ "conversationId", "eventId", "receivedAt", "source", "status" ],
         "type" : "object"
       },
-      "AppLight" : {
+      "WebhookEndpoint" : {
+        "description" : "The public address of an automation triggered by a webhook. Callers POST to `url` with `Authorization: Bearer <secret>`, or sign the raw body with HMAC-SHA256 (`X-Breign-Signature: sha256=<hex>`; with `X-Breign-Timestamp: <unix seconds>` the signature covers `<timestamp>.<body>`). Optional headers: `Idempotency-Key`, `X-Breign-Thread`.",
         "properties" : {
           "id" : {
             "type" : "string"
           },
-          "name" : {
+          "url" : {
             "type" : "string"
           },
-          "description" : {
+          "status" : {
+            "enum" : [ "active", "disabled" ],
             "type" : "string"
           },
-          "agentId" : {
+          "runAsUserId" : {
+            "description" : "The organization member the conversations run as (user-scoped MCP tools, quotas, history).",
             "type" : "string"
           },
-          "authSecret" : {
+          "lastEventAt" : {
+            "format" : "date-time",
+            "nullable" : true,
             "type" : "string"
           },
-          "streamingEnabled" : {
-            "type" : "boolean"
-          },
-          "voiceId" : {
+          "createdAt" : {
+            "format" : "date-time",
             "type" : "string"
           },
-          "voiceModelId" : {
+          "updatedAt" : {
+            "format" : "date-time",
             "type" : "string"
           },
-          "connected" : {
-            "type" : "boolean"
+          "secret" : {
+            "description" : "Only returned when the endpoint is created and after a rotation.",
+            "type" : "string"
+          }
+        },
+        "required" : [ "createdAt", "id", "lastEventAt", "runAsUserId", "status", "updatedAt", "url" ],
+        "type" : "object"
+      },
+      "WebhookEndpointUpdate" : {
+        "minProperties" : 1,
+        "properties" : {
+          "runAsUserId" : {
+            "description" : "Another member than the caller requires an organization admin.",
+            "type" : "string"
           },
-          "profilePicture" : {
+          "status" : {
+            "enum" : [ "active", "disabled" ],
             "type" : "string"
           }
         },
-        "required" : [ "agentId", "authSecret", "connected", "id", "name", "streamingEnabled", "voiceId", "voiceModelId" ],
         "type" : "object"
       },
-      "AppCreateRequest" : {
+      "WebhookEventList" : {
         "properties" : {
-          "name" : {
+          "events" : {
+            "items" : {
+              "$ref" : "#/components/schemas/WebhookEvent"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "events" ],
+        "type" : "object"
+      },
+      "WebhookEvent" : {
+        "description" : "A call received on the webhook, and where it is in the queue.",
+        "properties" : {
+          "id" : {
             "type" : "string"
           },
-          "description" : {
+          "status" : {
+            "$ref" : "#/components/schemas/ExternalEventStatus"
+          },
+          "receivedAt" : {
+            "format" : "date-time",
             "type" : "string"
           },
-          "agentId" : {
+          "finishedAt" : {
+            "format" : "date-time",
+            "nullable" : true,
             "type" : "string"
           },
-          "streamingEnabled" : {
-            "type" : "boolean"
+          "attempts" : {
+            "type" : "integer"
           },
-          "voiceProvider" : {
+          "lastError" : {
+            "nullable" : true,
             "type" : "string"
           },
-          "voiceProviderApiKey" : {
+          "thread" : {
+            "nullable" : true,
             "type" : "string"
           },
-          "voiceProviderOrganization" : {
+          "contentType" : {
             "type" : "string"
           },
-          "voiceId" : {
+          "runId" : {
+            "nullable" : true,
             "type" : "string"
           },
-          "voiceModelId" : {
+          "conversationId" : {
+            "nullable" : true,
             "type" : "string"
+          }
+        },
+        "required" : [ "attempts", "contentType", "conversationId", "finishedAt", "id", "lastError", "receivedAt", "runId", "status", "thread" ],
+        "type" : "object"
+      },
+      "WebhookTestRequest" : {
+        "properties" : {
+          "body" : {
+            "description" : "The JSON body of the test call (default `{\"test\": true}`)."
           },
-          "speechToText" : {
+          "thread" : {
+            "description" : "Sent as `X-Breign-Thread`.",
+            "maxLength" : 200,
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
+      "WebhookTestResponse" : {
+        "properties" : {
+          "eventId" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "eventId" ],
+        "type" : "object"
+      },
+      "AppLight" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "authSecret" : {
+            "type" : "string"
+          },
+          "streamingEnabled" : {
+            "type" : "boolean"
+          },
+          "voiceId" : {
+            "type" : "string"
+          },
+          "voiceModelId" : {
+            "type" : "string"
+          },
+          "connected" : {
+            "type" : "boolean"
+          },
+          "profilePicture" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "authSecret", "connected", "id", "name", "streamingEnabled", "voiceId", "voiceModelId" ],
+        "type" : "object"
+      },
+      "AppCreateRequest" : {
+        "properties" : {
+          "name" : {
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "streamingEnabled" : {
+            "type" : "boolean"
+          },
+          "voiceProvider" : {
+            "type" : "string"
+          },
+          "voiceProviderApiKey" : {
+            "type" : "string"
+          },
+          "voiceProviderOrganization" : {
+            "type" : "string"
+          },
+          "voiceId" : {
+            "type" : "string"
+          },
+          "voiceModelId" : {
+            "type" : "string"
+          },
+          "speechToText" : {
             "$ref" : "#/components/schemas/SpeechToTextConfig"
           },
           "lipsync" : {
@@ -31788,6 +32438,323 @@
         "required" : [ "assignees", "description", "priority", "reviewer", "startMode", "title", "workspacePaths" ],
         "type" : "object"
       },
+      "AutomationTriggerKind" : {
+        "description" : "What starts the automation, as shown in lists — its schedule, a GitLab mention, or its webhook.",
+        "enum" : [ "schedule", "gitlab", "webhook" ],
+        "type" : "string"
+      },
+      "AutomationList" : {
+        "properties" : {
+          "items" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AutomationSummary"
+            },
+            "type" : "array"
+          },
+          "total" : {
+            "type" : "integer"
+          },
+          "stats" : {
+            "$ref" : "#/components/schemas/AutomationStats"
+          }
+        },
+        "required" : [ "items", "stats", "total" ],
+        "type" : "object"
+      },
+      "AutomationSummary" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "message" : {
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "mode" : {
+            "enum" : [ "once", "recurring" ],
+            "type" : "string"
+          },
+          "status" : {
+            "enum" : [ "active", "paused", "done" ],
+            "type" : "string"
+          },
+          "trigger" : {
+            "$ref" : "#/components/schemas/AutomationTriggerKind"
+          },
+          "schedule" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/TaskSchedule"
+            } ],
+            "nullable" : true
+          },
+          "timezone" : {
+            "type" : "string"
+          },
+          "nextRunAt" : {
+            "format" : "date-time",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "callbackUrl" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "lastRun" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AutomationLastRun"
+            } ],
+            "nullable" : true
+          },
+          "days" : {
+            "description" : "The last 7 UTC days, oldest first.",
+            "items" : {
+              "$ref" : "#/components/schemas/AutomationDayCount"
+            },
+            "type" : "array"
+          },
+          "runs7d" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "agentId", "agentName", "callbackUrl", "days", "id", "lastRun", "message", "mode", "name", "nextRunAt", "runs7d", "schedule", "status", "timezone", "trigger" ],
+        "type" : "object"
+      },
+      "AutomationLastRun" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/AutomationRunOutcome"
+          },
+          "triggeredAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "finishedAt" : {
+            "format" : "date-time",
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "finishedAt", "id", "status", "triggeredAt" ],
+        "type" : "object"
+      },
+      "AutomationRunOutcome" : {
+        "enum" : [ "success", "error", "running" ],
+        "type" : "string"
+      },
+      "AutomationDayCount" : {
+        "properties" : {
+          "date" : {
+            "description" : "UTC day, YYYY-MM-DD.",
+            "type" : "string"
+          },
+          "success" : {
+            "type" : "integer"
+          },
+          "error" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "date", "error", "success" ],
+        "type" : "object"
+      },
+      "AutomationStats" : {
+        "properties" : {
+          "active" : {
+            "type" : "integer"
+          },
+          "event" : {
+            "description" : "Active automations triggered by a GitLab mention or a webhook.",
+            "type" : "integer"
+          },
+          "runs24h" : {
+            "type" : "integer"
+          },
+          "runs7d" : {
+            "type" : "integer"
+          },
+          "failures7d" : {
+            "type" : "integer"
+          },
+          "pending" : {
+            "description" : "Mentions and webhook calls of the organization not handled yet.",
+            "type" : "integer"
+          }
+        },
+        "required" : [ "active", "event", "failures7d", "pending", "runs24h", "runs7d" ],
+        "type" : "object"
+      },
+      "AutomationRunList" : {
+        "properties" : {
+          "runs" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AutomationRun"
+            },
+            "type" : "array"
+          },
+          "nextBefore" : {
+            "description" : "Pass as `before` to get the next page; null on the last one.",
+            "format" : "date-time",
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "nextBefore", "runs" ],
+        "type" : "object"
+      },
+      "AutomationRun" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "taskId" : {
+            "type" : "string"
+          },
+          "taskName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/AutomationRunOutcome"
+          },
+          "triggeredAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "startedAt" : {
+            "format" : "date-time",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "finishedAt" : {
+            "format" : "date-time",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "durationMs" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "conversationId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "trigger" : {
+            "$ref" : "#/components/schemas/AutomationTriggerKind"
+          },
+          "source" : {
+            "$ref" : "#/components/schemas/AutomationRunSource"
+          },
+          "delivery" : {
+            "$ref" : "#/components/schemas/AutomationRunDelivery"
+          },
+          "reply" : {
+            "description" : "Start of the agent answer (500 characters at most).",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "error" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "agentName", "conversationId", "delivery", "durationMs", "error", "finishedAt", "id", "reply", "source", "startedAt", "status", "taskId", "taskName", "trigger", "triggeredAt" ],
+        "type" : "object"
+      },
+      "AutomationRunSource" : {
+        "description" : "What triggered the run. `schedule`: `schedule`, `timezone`, `mode`. `gitlab`: `author`, `authorUsername`, `ref`, `title`, `url`, `text` (untrusted user content). `webhook`: `thread`, `contentType`.",
+        "properties" : {
+          "kind" : {
+            "$ref" : "#/components/schemas/AutomationTriggerKind"
+          },
+          "schedule" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/TaskSchedule"
+            } ],
+            "nullable" : true
+          },
+          "timezone" : {
+            "type" : "string"
+          },
+          "mode" : {
+            "enum" : [ "once", "recurring" ],
+            "type" : "string"
+          },
+          "author" : {
+            "type" : "string"
+          },
+          "authorUsername" : {
+            "type" : "string"
+          },
+          "ref" : {
+            "type" : "string"
+          },
+          "title" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "url" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "text" : {
+            "type" : "string"
+          },
+          "thread" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "contentType" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "kind" ],
+        "type" : "object"
+      },
+      "AutomationRunDelivery" : {
+        "description" : "What became of the result — the reply in the GitLab thread, the caller's callback, or nothing.",
+        "properties" : {
+          "kind" : {
+            "enum" : [ "gitlab_reply", "callback", "none" ],
+            "type" : "string"
+          },
+          "eventStatus" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/ExternalEventStatus"
+            } ],
+            "nullable" : true
+          },
+          "url" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "error" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "error", "eventStatus", "kind", "url" ],
+        "type" : "object"
+      },
       "GitlabIntegration" : {
         "description" : "A GitLab instance linked to an organization. Its projects send webhooks to `webhookUrl`.",
         "properties" : {