---
title: "Create a Deletion"
method: POST
path: "/data-deletions/v3.0"
tags: ["Create a Deletion"]
---

# Create a Deletion

`POST /data-deletions/v3.0`

Creates a task that specifies a list of users in a project to delete

## Query parameters

- `token` string

## Request body

- object
  - `distinct_ids` string[]
  - `compliance_type` string — Select CCPA or GDPR. Default is GDPR.

## Response `201`

Success

- JobCreated — A JSON response object containing the task_id of the retrieval/deletion job.
  - `status` string, required — The status of the response
  - `results` object, required
    - `task_id` string — The task_id of the retrieval/deletion job.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

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