From f453bd6ac53289594d3615a759e5fcba26134b43 Mon Sep 17 00:00:00 2001
From: "Joshua M. Boniface" <joshua@boniface.me>
Date: Sat, 16 Nov 2024 13:47:48 -0500
Subject: [PATCH] Add automirror and adjust snapshot age

---
 docs/manuals/swagger.json | 42 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 41 insertions(+), 1 deletion(-)

diff --git a/docs/manuals/swagger.json b/docs/manuals/swagger.json
index 9d00162..5be51ab 100644
--- a/docs/manuals/swagger.json
+++ b/docs/manuals/swagger.json
@@ -1520,7 +1520,7 @@
                     "items": {
                         "properties": {
                             "age": {
-                                "description": "Human-readable age of the snapshot in the largest viable unit (seconds, minutes, hours, days)",
+                                "description": "Age of the snapshot in seconds",
                                 "type": "string"
                             },
                             "name": {
@@ -7745,6 +7745,46 @@
                 ]
             }
         },
+        "/api/v1/vm/automirror": {
+            "post": {
+                "description": "",
+                "parameters": [
+                    {
+                        "description": "A list of email addresses to send failure and report emails to, comma-separated",
+                        "in": "query",
+                        "name": "email_recipients",
+                        "required": false,
+                        "type": "string"
+                    },
+                    {
+                        "default": false,
+                        "description": "If set and true, only sends a report email to email_recipients when there is an error with at least one mirror",
+                        "in": "query",
+                        "name": "email_errors_only",
+                        "required": false,
+                        "type": "boolean"
+                    }
+                ],
+                "responses": {
+                    "202": {
+                        "description": "Accepted",
+                        "schema": {
+                            "$ref": "#/definitions/CeleryTask"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad request",
+                        "schema": {
+                            "$ref": "#/definitions/Message"
+                        }
+                    }
+                },
+                "summary": "Trigger a cluster automirror job",
+                "tags": [
+                    "provisioner"
+                ]
+            }
+        },
         "/api/v1/vm/{vm}": {
             "delete": {
                 "description": "",