From 4d2e55f16a44e04ad0562b3054be63a66b22ad08 Mon Sep 17 00:00:00 2001
From: Marco Trevisan <mail@3v1n0.net>
Date: Thu, 3 Feb 2022 10:25:26 +0100
Subject: [PATCH] API: Mention compressed parameter for performing backups
 (#1188)

Related to: https://github.com/home-assistant/supervisor/pull/3378
---
 docs/api/supervisor/endpoints.md | 23 +++++++++++++----------
 docs/api/supervisor/models.md    |  3 ++-
 2 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/docs/api/supervisor/endpoints.md b/docs/api/supervisor/endpoints.md
index 13bedb2a..a63291a7 100644
--- a/docs/api/supervisor/endpoints.md
+++ b/docs/api/supervisor/endpoints.md
@@ -711,6 +711,7 @@ Return a list of [Backups](api/supervisor/models.md#backup)
       "type": "partial",
       "size": 44,
       "protected": true,
+      "compressed": true,
       "content": {
         "homeassistant": true,
         "addons": ["awesome_addon"],
@@ -729,10 +730,11 @@ Create a full backup.
 
 **Payload:**
 
-| key      | type   | optional | description                                |
-| -------- | ------ | -------- | ------------------------------------------ |
-| name     | string | True     | The name you want to give the backup     |
-| password | string | True     | The password you want to give the backup |
+| key        | type    | optional | description                              |
+| ---------- | ------- | -------- | -----------------------------------------|
+| name       | string  | True     | The name you want to give the backup     |
+| password   | string  | True     | The password you want to give the backup |
+| compressed | boolean | True     | `false` to create uncompressed backups   |
 
 **Example response:**
 
@@ -764,12 +766,13 @@ Create a partial backup.
 
 **Payload:**
 
-| key      | type   | optional | description                                 |
-| -------- | ------ | -------- | ------------------------------------------- |
-| name     | string | True     | The name you want to give the backup      |
-| password | string | True     | The password you want to give the backup  |
-| addons   | list   | True     | A list of strings representing add-on slugs |
-| folders  | list   | True     | A list of strings representing directories  |
+| key        | type    | optional | description                                 |
+| ---------- | ------- | -------- | ------------------------------------------- |
+| name       | string  | True     | The name you want to give the backup        |
+| password   | string  | True     | The password you want to give the backup    |
+| addons     | list    | True     | A list of strings representing add-on slugs |
+| folders    | list    | True     | A list of strings representing directories  |
+| compressed | boolean | True     | `false` to create uncompressed backups      |
 
 **You need to supply at least one key in the payload.**
 
diff --git a/docs/api/supervisor/models.md b/docs/api/supervisor/models.md
index f012e77c..9fa31a2f 100644
--- a/docs/api/supervisor/models.md
+++ b/docs/api/supervisor/models.md
@@ -175,7 +175,8 @@ These models are describing objects that are getting returned from the superviso
 | name      | string  | The name given to the backup                                        |
 | type      | string  | The type of backup (full, partial)                                  |
 | protected | boolean | `true` if the backup is password protected                          |
-| content | dictionary | A dictionary describing the content of the backup                        |
+| content | dictionary | A dictionary describing the content of the backup                  |
+| compressed | boolean | `true` if the backup is saved in a compressed archive              |
 
 ### Backup -> content