> ## Documentation Index
> Fetch the complete documentation index at: https://docs.virtuous.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Replace a Segment

> Reassigns the records that reference one segment to another.

Send `currentSegmentId` and `newSegmentId`; the response is the number of records moved.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.virtuous.org/llms.txt).