---
title: "Update Multiple Elements"
method: PUT
path: "/lists/{list_id}/elements"
tags: ["elements"]
---

# Update Multiple Elements

`PUT /lists/{list_id}/elements`

Update Multiple Elements in list.If element does not exist, it is created in list.
The returned "not_found" field will never be preset.

Required security scopes:
  * `api:update`

## Path parameters

- `list_id` string, required

## Query parameters

- `results` boolean

## Request body

- Element[]
  - `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.

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[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)