Skip to main content
DELETE
/
v2
/
lists
/
{id}
/
items
Remove items from list
curl --request DELETE \
  --url https://api.village.do/v2/lists/{id}/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "item_ids": [
    "1",
    "2",
    "3"
  ]
}
'
{
  "data": {
    "removed": 123
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Use the API token from your personal Village account: https://village.do/settings#api-keys

For verified apps accessing user data, create a user token: https://docs.village.do/api-reference-v2/authentication/create-authorization

Path Parameters

​
id
string
required

List ID

Minimum string length: 1
Example:

"123"

Body

application/json

Request body for removing items from a list

​
item_ids
string[]
required

Array of item IDs to remove from the list

Required array length: 1 - 100 elements
Minimum string length: 1
Example:
["1", "2", "3"]

Response

Items removed successfully

​
data
object
required

Response after removing items from a list

​
metadata
object
required