Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

YugabyteDB Asynchronous Replication API

The Asynchronous Replication API from YugabyteDB — 6 operation(s) for asynchronous replication.

YugabyteDB Asynchronous Replication API is one of 73 APIs that YugabyteDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Asynchronous Replication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 9 operations across 6 paths, and defines 27 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://cloud.yugabyte.com/api/public/v1.

9 operations 6 paths 27 schemas 1 DELETE1 GET6 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://cloud.yugabyte.com/api/public/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

YugabyteDB Asynchronous Replication API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — API key obtained from the YugabyteDB Aeon UI under User Profile API Keys. Pass the key as a Bearer token in the Authorization header.

Paths & Operations 9

Across 6 paths, the API surfaces 9 operations — 1 DELETE, 1 GET, 6 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Asynchronous Replication 9
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/need_bootstrap
YugabyteDB Anywhere Whether Tables Need Bootstrap Before Setting Up Cross Cluster Replication
needBootstrapTable 5 params body → 200
POST
/api/v1/customers/{cUUID}/xcluster_configs
YugabyteDB Anywhere Create Xcluster Config
createXClusterConfig 2 params body → 200
POST
/api/v1/customers/{cUUID}/xcluster_configs/syncdeprecated
YugabyteDB Anywhere Sync Xcluster Config - Deprecated
syncXClusterConfig 3 params → 200
DELETE
/api/v1/customers/{cUUID}/xcluster_configs/{xccUUID}
YugabyteDB Anywhere Delete Xcluster Config
deleteXClusterConfig 4 params → 200
GET
/api/v1/customers/{cUUID}/xcluster_configs/{xccUUID}
YugabyteDB Anywhere Get Xcluster Config
getXClusterConfig 3 params → 200
POST
/api/v1/customers/{cUUID}/xcluster_configs/{xccUUID}
YugabyteDB Anywhere Restart Xcluster Config
restartXClusterConfig 4 params body → 200
PUT
/api/v1/customers/{cUUID}/xcluster_configs/{xccUUID}
YugabyteDB Anywhere Edit Xcluster Config
editXClusterConfig 3 params body → 200
POST
/api/v1/customers/{cUUID}/xcluster_configs/{xccUUID}/need_bootstrap
YugabyteDB Anywhere Whether Tables in an XCluster Replication Config Have Fallen Far Behind and Need Bootstrap
NeedBootstrapXClusterConfig 3 params body → 200
POST
/api/v1/customers/{cUUID}/xcluster_configs/{xccUUID}/sync
YugabyteDB Anywhere Sync Xcluster Config (V2)
syncXClusterConfigV2 3 params → 200

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are XClusterConfigGetResp_2 (27 properties), XClusterConfigGetResp (27 properties), PitrConfig (16 properties), TableInfoResp (16 properties). Each schema is shown below with its type and property counts.

XClusterConfigEditFormData
object
xcluster edit form
9 properties
TableInfoResp
object
Table information response
16 properties
NamespaceInfoResp
object
Namespace information response
3 properties
XClusterTableConfig
object
13 properties 2 required
XClusterConfigGetResp
object
xcluster get response
27 properties 2 required
XClusterConfigCreateFormData
object
xcluster create form
7 properties 4 required
BootstrapBackupParams
object
Backup parameters for bootstrapping
2 properties 1 required
XClusterConfigRestartFormData
object
xcluster restart form
3 properties 1 required
PitrConfig
object
PITR config created on the universe
16 properties 3 required
BootstrapParams
object
Bootstrap parameters
3 properties 1 required
XClusterConfigNeedBootstrapFormData
object
3 properties 1 required
XClusterNamespaceConfig
object
7 properties 3 required
RestartBootstrapParams
object
Bootstrap parameters for restarting
1 property 1 required
YBPTask
object
2 properties
XClusterConfigEditFormData_2
object
xcluster edit form
9 properties
TableInfoResp_2
object
Table information response
16 properties
NamespaceInfoResp_2
object
Namespace information response
3 properties
XClusterTableConfig_2
object
13 properties 2 required
XClusterConfigGetResp_2
object
xcluster get response
27 properties 2 required
XClusterConfigCreateFormData_2
object
xcluster create form
7 properties 4 required
BootstrapBackupParams_2
object
Backup parameters for bootstrapping
2 properties 1 required
XClusterConfigRestartFormData_2
object
xcluster restart form
3 properties 1 required
PitrConfig_2
object
PITR config created on the universe
16 properties 3 required
BootstrapParams_2
object
Bootstrap parameters
3 properties 1 required
XClusterConfigNeedBootstrapFormData_2
object
3 properties 1 required
XClusterNamespaceConfig_2
object
7 properties 3 required
YBPTask_2
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yugabytedb-asynchronous-replication-api-openapi.yml Raw ↑

Other APIs YugabyteDB publishes across the network.

YugabyteDB Access Keys API
YugabyteDB Accounts API
YugabyteDB Alerts API
YugabyteDB AllowLists API
YugabyteDB Audit API
YugabyteDB Authentication API
YugabyteDB Availability Zones API
YugabyteDB Backup and Restore API
YugabyteDB Backups API
YugabyteDB Certificate Info API
YugabyteDB Cloud providers API
YugabyteDB Clusters API