Skip to main content
Version: 1.18.x

Replication API Specification Reference

ReductStore supports append-only replication. This feature allows you to replicate records from one bucket to another. To use the replication feature, you must create a replication task with the source and destination buckets. This reference describes the API for managing replication tasks.

The API is available at the /api/v1/replications endpoint and requires an access token with full access.

For more information about replications, read the Replication Guide.

Get a List of Replication Tasks​

The method returns a list of replication Task with their statuses.

Changes:

  • v1.8: The endpoint was added
  • v1.18: Added the mode field to show whether replication is enabled, paused, or disabled
GET
/api/v1/replications
Get a list of replication tasks

Show Information about a Replication Task​

This method provides complete information about a replication task, including diagnostics and settings.

Changes:

  • v1.8: The endpoint was added
  • v1.14: The when field was added with conditional query to filter records
  • v1.18: Added the mode field to the replication info and settings
GET
/api/v1/replications/:replication_name
Show information about a replication task

Create a New Replication Task​

The method creates a replication task with given settings.

Changes:

  • v1.8: The endpoint was added
  • v1.14: The when field was added with conditional query to filter records
  • v1.18: Added optional mode to start replications as enabled, paused, or disabled
POST
/api/v1/replications/:replication
Create a new replication task

Update an Existing Replication Task​

The method updates an existing replication task with given settings. To use this method, you need an access token with full access.

Changes:

  • v1.8: The endpoint was added
  • v1.14: The when field was added with conditional query to filter records
  • v1.18: Added optional mode to switch between enabled, paused, and disabled
PUT
/api/v1/replications/:replication_name
Update an existing replication task

Update Replication Mode​

Use this endpoint to switch a replication task between enabled, paused, and disabled without overwriting other settings.

Changes:

  • v1.18: The endpoint was added
PATCH
/api/v1/replications/:replication_name/mode
Update replication mode

Delete a Replication Task​

The method deletes a replication task.

Changes:

  • v1.8: The endpoint was added
DELETE
/api/v1/replications/:replication_name
Delete a replication task