---
updatedAt: 2025-05-20T20:30:11.000Z
agentTools:
  projectIndex: https://docs.documotor.com/llms.txt
---

# List Backups

Gets a list of all backups in the unit used for authentication.

The authentication parameters are `username` and `password`.

* The `username` is the Unit ID of the unit the content is in.
* The `password` is the API secret of the unit.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Documotor",
    "description": "Generate documents, presentations, and spreadsheets based on data.\nDocumotor is a modern document generation platform that allows you to use transformation steps and templates designed in Microsoft 365, to create documents based on any data.",
    "version": "1.0",
    "contact": {
      "name": "Documotor Support",
      "url": "https://support.omnidocs.com/hc/en-us/requests/new",
      "email": "support@documotor.com"
    }
  },
  "x-ms-connector-metadata": [
    {
      "propertyName": "Website",
      "propertyValue": "https://omnidocs.com/"
    },
    {
      "propertyName": "Privacy policy",
      "propertyValue": "https://omnidocs.com/privacy-policy-2"
    },
    {
      "propertyName": "Categories",
      "propertyValue": "Productivity;Content and Files"
    }
  ],
  "security": [
    {
      "basic-auth": []
    }
  ],
  "servers": [
    {
      "url": "https://documotor.com/api"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  },
  "paths": {
    "/backup": {
      "get": {
        "tags": [
          "Backup"
        ],
        "summary": "List Backups",
        "description": "Gets a list of all backups in the unit used for authentication.",
        "responses": {
          "200": {
            "description": "List of backup IDs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "401": {
            "description": "If authorization is invalid",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnauthorizedResult"
                }
              }
            }
          },
          "422": {
            "description": "If authorization is valid and an error happens",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnprocessableEntityResult"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "basic-auth": {
        "type": "http",
        "scheme": "basic",
        "description": "Basic authentication with Unit ID and API Secret. To authenticate,  use the Unit ID as the username and the API Secret as the password.\n"
      }
    },
    "schemas": {
      "UnauthorizedResult": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "UnprocessableEntityResult": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```