---
title: "Unassign contacts from a list"
method: DELETE
path: "/api/v2/lists/{id}/contacts"
tags: ["Lists"]
---

# Unassign contacts from a list

`DELETE /api/v2/lists/{id}/contacts`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Lists/deleteContactsFromList" target="_blank">Try in sandbox</a><br>> When you remove contacts from a specific list, they will be deleted permanently, unless they are first saved in another list.

## Path parameters

- `id` integer, required

## Request body

- object
  - `contacts` string, required — Comma-separated array of [Contacts](https://docs.textmagic.com/#tag/Contacts) IDs.

## Response `204`

Request executed with success.

## Other responses

- `401` — Unauthorized request.
- `403` — Returned when trying to edit a list shared to the current user.
- `404` — Request data not found.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)