---
title: "DELETE a List"
method: DELETE
path: "/contact_lists/{list_id}"
tags: ["Contact Lists"]
---

# DELETE a List

`DELETE /contact_lists/{list_id}`

Deletes the specified contact list and its membership. DELETE List requests are processed asynchronously, and you can track the status of the request by making a GET call to the URI shown in the `_links` property in the response.

## Path parameters

- `list_id` string, uuid, required

## Response `202`

Accepted

- ActivityDeleteListResponse
  - `activity_id` string, uuid — Unique ID for the delete list batch job.
  - `state` string — The state of the request: <p><ul> <li>initialized - request has been received</li> <li>processing - request is being processed</li> <li>completed - job completed</li> <li>cancelled - request was cancelled</li> <li>failed - job failed to complete</li> <li>timed_out - the request timed out before completing"</li> </ul> </p>
  - `created_at` string, date-time — Date and time that the request was received, in ISO-8601 format.
  - `updated_at` string, date-time — Date and time that the request status was updated, in ISO-8601 format.
  - `percent_done` integer — Job completion percentage
  - `activity_errors` string[] — Array of messages describing the errors that occurred.
  - `_links` object
    - `self` object — Link to the activity status to use in tracking the request status.
      - `href` string

## Other responses

- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `415` — Unsupported Media Type.
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/versions/4b4a534c818d/schema)