Skip to main content

ONLYOFFICE DocSpace Backup API

The browsable version of this reference, with a request builder and code samples, is published at https://api.onlyoffice.com/docspace/api-backend/usage-api/.

All URIs are relative to https://yourportal.onlyoffice.com, where the host is the address of your DocSpace instance.

Backup​

MethodHTTP requestDescription
cancelBackupPOST /api/2.0/backup/cancelbackupCancel the running backup
createBackupSchedulePOST /api/2.0/backup/createbackupscheduleCreate the backup schedule
deleteBackupDELETE /api/2.0/backup/deletebackup/{id}Delete the backup
deleteBackupHistoryDELETE /api/2.0/backup/deletebackuphistoryDelete the backup history
deleteBackupScheduleDELETE /api/2.0/backup/deletebackupscheduleDelete the backup schedule
getBackupHistoryGET /api/2.0/backup/getbackuphistoryGet the backup history
getBackupProgressGET /api/2.0/backup/getbackupprogressGet the backup progress
getBackupScheduleGET /api/2.0/backup/getbackupscheduleGet the backup schedule
getBackupsCountGET /api/2.0/backup/getbackupscountGet the number of backups
getBackupsCountsGET /api/2.0/backup/getbackupscountbypaidGet free and paid backup counts
getBackupsServiceStateGET /api/2.0/backup/getservicestateCheck whether backups are enabled
getRestoreProgressGET /api/2.0/backup/getrestoreprogressGet the restoring progress
startBackupPOST /api/2.0/backup/startbackupStart the backup
startBackupRestorePOST /api/2.0/backup/startrestoreStart the restoring process

Authorization​

cookieAuth​

  • Type: API key
  • API key parameter name: asc_auth_key
  • Location:

bearerAuth​

  • Type: HTTP Bearer Token authentication

asc_auth_key​

  • Type: API key
  • API key parameter name: asc_auth_key
  • Location:

Basic​

  • Type: HTTP basic authentication

Bearer​

  • Type: HTTP Bearer Token authentication (JWT)

ApiKeyBearer​

  • Type: API key
  • API key parameter name: ApiKeyBearer
  • Location: HTTP header

OAuth2​

  • Type: OAuth
  • Flow: accessCode
  • Authorization URL:
  • Scopes:
    • read: Read access to protected resources
    • write: Write access to protected resources

OpenId​

x-signature​

  • Type: API key
  • API key parameter name: x-signature
  • Location: