Skip to main content
DELETE
/
v2
/
lists
/
{id}
Delete a list
curl --request DELETE \
  --url https://api.village.do/v2/lists/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "message": "<string>"
  },
  "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"

Response

List deleted successfully

​
data
object
required

Response after deleting a list

​
metadata
object
required