---
title: "Rename a list or change its settings"
method: PATCH
path: "/lists/{id}"
tags: ["Lists"]
---

# Rename a list or change its settings

`PATCH /lists/{id}`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/lists/{id}`
- Auth: API key in header `X-API-Key`

Only the fields sent change.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string
  - `handles` string[]
  - `feed` 'accounts' | 'network'
  - `sectors` string[]
  - `max_followers` integer, nullable
  - `min_tracking` integer, nullable

## Response `200`

The updated list

- object

## Other responses

- `404`: List not found

## Changes

- **2026-10-19** `6880b29e94c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/lists/:id/patch.md)

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)