---
title: "Replace a list"
method: PUT
path: "/people/2/persons/{personId}/lists/{listName}"
tags: ["customer-engagement", "people", "custom-attributes-lists"]
deprecated: true
---

# Replace a list

`PUT /people/2/persons/{personId}/lists/{listName}`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/people/2/persons/{personId}/lists/{listName}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

> **Deprecated.**

Replaces a list and returns all items of the updated list.

## Path parameters

- `personId` integer, required
- `listName` string, required

## Request body

- object[]

## Response `200`

Items are replaced

## Other responses

- `400`: Bad request:<ul><li>empty body</li><li>__id fields passed</li><li>fields undefined in the list schema passed</li><li>unexpected type of a field value passed</li><li>size of the resulting list exceeds 128 items</li></ul>
- `401`: Unauthorized
- `403`: Forbidden
- `404`: <ul><li>no profile with a given personId</li><li>no custom attributes with given listNames</li></ul>
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)