---
title: "Deletar múltiplos contatos"
method: DELETE
path: "/v2/contacts"
tags: ["conversas-v2-contacts"]
---

# Deletar múltiplos contatos

`DELETE /v2/contacts`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v2/contacts`
- Auth: HTTP bearer

ℹ️ API disponível apenas para o plano Advanced.

Deletar múltiplos contatos usando filtros.
É **obrigatório** enviar um de: `tag_name`, `integration` ou `$all`.
O cliente pode excluir por etiqueta pelo nome (`tag_name`).

⚠️ As exclusões realizadas neste recurso são irreversíveis e definitivas.

## Request body

- union
  - object
    - `tag_name` string, required: Nome da etiqueta a qual os contatos estão associados.
  - object
    - `integration` string, required: Nome da integração a qual os contatos estão ligados.
  - object
    - `$all` boolean, required: Sinaliza a exclusão de TODOS os contatos da empresa.

## Response `200`

Contatos excluídos com sucesso

- object
  - `contacts_count` integer, required: Número de contatos excluídos.

## Other responses

- `400`: Bad request
- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `404`: Resource not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/revisions/730a895096d0?raw)