---
title: "Replace the entire List"
method: PUT
path: "/lists/{list_token}"
tags: ["Lists"]
---

# Replace the entire List

`PUT /lists/{list_token}`

Overwrite the entire List with the contents of the submitted array

## Request body

- Schema[] — unresolved $ref

## Response `200`

Successfully replaced List

- object
  - `status_code` number
  - `error` object
  - `timestamp` integer
  - `name` string
  - `list_token` string
  - `data` string
  - `records_added` integer
  - `total_records` integer

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)