Backup and Restore API


Backing up and restoring your cluster using the API

You can use the Backup and Restore API to create and restore backups of your cluster.

IMPORTANT: See the Limitations section.


Access to the Backup and Restore API is proxied through Admin Router on each master node, using the following route:


To determine the URL of your cluster, see Cluster Access.


The Backup and Restore API request and response bodies are formatted in JSON. Requests must include the accept header:

Accept: application/json

Responses include the content type header:

Content-Type: application/json


All Backup and Restore API routes require authentication to use.

To authenticate API requests, see Obtaining an authentication token and Passing an authentication token.

The Backup and Restore API also requires authorization via the following permissions:

Resource ID Action
dcos:adminrouter:ops:system-backup full

All routes can also be reached by users with the dcos:superuser permission.

To assign permissions to your account, see the permissions reference.

API reference

The Backup and Restore API allows you to manage backup and restore operations on your DC/OS cluster.