Backup Service API

  • reference
March 23, 2025
+ 12
The Backup Service API allows full and incremental data-backups to be planned and scheduled; allows the scheduling of merges of previously made backups; and allows existing backups to be archived.

APIs in this Section

The Backup Service API endpoints can be grouped into several categories:

For an overview of the Backup Service, see Backup Service. For information on using Couchbase Server Web Console to configure and use the Backup Service, see Manage Backup and Restore.

All calls require the Full Admin role, and use port 8097. Each URI, in Couchbase Server Enterprise Edition Version 7.0, must be prefixed with /api/v1. Note that for all cluster references, in Couchbase Server Enterprise Edition Version 7.0 and 7.1, only the host cluster is supported, and is referred to as self.

For a list of the methods and URIs covered in these pages, see the tables below.

Cluster

HTTP Method URI Documented at

GET

/api/v1/cluster/self

Get Information on the Cluster

Configuration

HTTP Method URI Description

GET

/api/v1/config

Manage Backup Configuration

POST

/api/v1/config

Manage Backup Configuration

PUT

/api/v1/config

Manage Backup Configuration

GET

/api/v1/nodesThreadsMap

Manage Backup Service Threads

PATCH

/api/v1/nodesThreadsMap

Manage Backup Service Threads

POST

/api/v1/nodesThreadsMap

Manage Backup Service Threads

Repository

HTTP Method URI Documented at

GET

/api/v1/cluster/self/repository/<'active'|'archived'|'imported'>

Get Backup Repository Information

GET

/api/v1/cluster/self/repository/active/<repository-id>

Get Backup Repository Information

GET

/api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/info

Get Backup Repository Information

POST

/api/v1/cluster/self/repository/active/<repository-id>

Create a Repository

POST

/api/v1/cluster/self/repository/<'archived'|'imported'>/<repository-id>/restore

Restore Data

POST

/api/v1/cluster/self/repository/import

Import a Repository

POST

/api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/examine

Examine Backed-Up Data

POST

/api/v1/cluster/self/repository/active/<repository-id>/backup

Perform an Immediate Backup

POST

/api/v1/cluster/self/repository/active/<repository-id>/merge

Perform an Immediate Merge

POST

/api/v1/cluster/self/repository/active/<repository-id>/archive

Archive a Repository

POST

/api/v1/cluster/self/repository/active/<repository-id>/pause

Pause and Resume Tasks

POST

/api/v1/cluster/self/repository/active/<repository-id>/resume

Pause and Resume Tasks

DELETE

/api/v1/cluster/self/repository/<'archived'|'imported'>/<repository-id>

Delete a Repository

DELETE

/api/v1/cluster/self/repository/<'archived'|'imported'>/<repository-id>?remove_repository

Delete a Repository

DELETE

/api/v1/cluster/self/repository/active/<repository-id>/backups/<backup-id>

Delete a Backup

Plan

HTTP Method URI Documented at

GET

/api/v1/cluster/plan

Get Backup Plan Information

GET

/api/v1/cluster/plan/<plan-id>

Get Backup Plan Information

POST

/api/v1/cluster/plan/<plan-id>

Create and Edit Plans

PUT

/api/v1/cluster/plan/<existing-plan-id>

Create and Edit Plans

DELETE

/api/v1/plan/<plan-id>

Delete a Plan

Task

HTTP Method URI Documented at

GET

/api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/taskHistory

Get Backup Task History

GET

/api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/taskHistory?<task-subset-specification-string>

Get Backup Task History

Data

HTTP Method URI Documented at

DELETE

/api/v1/cluster/self/repository/active/<repository-id>/backups/<backup-id>

Delete Backups