---
title: "Clone list"
method: PUT
path: "/lists/{list_id}/clone"
tags: ["lists"]
---

# Clone list

`PUT /lists/{list_id}/clone`

Creates a clone of the list to a new list with the supplied metadata.
The URL list is the source and the payload must contain the new list ID.

Required security scopes:
  * `api:manage`

## Path parameters

- `list_id` string, required

## Request body

- RankList
  - `id` string, required — The ID of the list to apply the operation on. Can be `a` to `z` (both upper/lower case), `0` to `9` or one of these characters `_-.`
  - `load_index` boolean — Load Index on server startup
  - `merge_size` integer — Merge adjacent Segments with less than this number of entries
  - `metadata` object — Custom metadata. String to String hash.
  - `populate` Element[] — Populate list with specified elements
    - `id` integer, required — ID of element
    - `payload` object — Custom payload. Stored untouched. On updates null means do not update. `{}` is the empty value.
    - `score` integer, required — Score of the element. Higher score gives higher placement.
    - `tie_breaker` integer — Tie breaker, used if score matches for consistent sorting. Higher value = higher placement if score is equal.
  - `set` string, required — Set used for storage
  - `split_size` integer — Split Segments larger than this number of entries

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Returned if the original list cannot be found
- `409` — Returned if the new list already exists.

---

[API](https://skmtc.net/vivino/apis/the-rankdb-api.md) · [All operations](https://skmtc.net/vivino/apis/the-rankdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivino/the-rankdb-api/revisions/7a45b5309a11/schema)