---
title: "Refresh Dynamic List"
method: POST
path: "/api/v1/lists/{list_id}/refresh"
tags: ["lists"]
---

# Refresh Dynamic List

`POST /api/v1/lists/{list_id}/refresh`

Reconcile a dynamic list's members from its criteria.

``membership_mode='live'`` lists also drop members that no longer match;
``accumulate`` lists stay add-only.

## Path parameters

- `list_id` string, uuid, required

## Response `200`

Successful Response

- DynamicListRefreshResult — Outcome of (re)materializing a dynamic list from its criteria.
  - `matched` integer, required
  - `added` integer, required
  - `removed` integer
  - `member_count` integer, required

## Other responses

- `404` — List not found
- `422` — Validation Error

---

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