Skip to main content
Version: Next

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