---
title: "DELETE | Excluir sincronização de grupo LDAP por [id]"
slug: "api-v2-delete-ldap-group-sync"
updated: 2026-11-03T14:57:57Z
published: 2026-11-03T14:57:57Z
canonical: "docs.senhasegura.io/api-v2-delete-ldap-group-sync"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE | Excluir sincronização de grupo LDAP por [id]

## Descrição

Exclua uma sincronização de grupo LDAP na plataforma Segura™. A plataforma realiza uma exclusão lógica: remove a sincronização e limpa os registros que a vinculam a suas roles, departamentos, perfis e usuários.

---

## Pré-requisitos

- Uma aplicação com a autorização **Users** concedida pelo administrador no A2A, com a permissão do recurso definida como **Leitura e escrita**. Para mais informações, acesse [Como gerenciar autorizações no A2A](/v4-2/docs/how-to-manage-authorizations-in-a2a).
- Um token de acesso OAuth 2.0 válido. Para mais informações, acesse [Como autenticar uma aplicação no A2A](/v4-2/docs/how-to-authenticate-an-application-in-a2a).
- O `ETag` atual da sincronização, retornado por [GET | Consultar sincronização de grupo LDAP por [id]](/v4-2/docs/api-v2-get-list-an-ldap-group-sync).

              Alerta

              

Os usuários e roles que a sincronização já criou permanecem na plataforma. Excluir a sincronização interrompe execuções futuras; não revoga os acessos concedidos por execuções anteriores. Revise esses acessos separadamente.

---

## Requisição

`DELETE` `/api/v2/iam/ldap-group-syncs/[id]`

### Parâmetros de caminho

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | int | Sim | Código de identificação único da sincronização. |

### Cabeçalhos

| Cabeçalho | Obrigatório | Descrição |
| --- | --- | --- |
| `If-Match` | Sim | O `ETag` da sincronização conforme lido pela última vez. A plataforma rejeita a requisição quando a versão armazenada é diferente, e a sincronização é preservada. |

### Exemplo de requisição `DELETE` `{{url}}/api/v2/iam/ldap-group-syncs/501`

---

## Resposta

```
HTTP/1.1 204 No Content
```

A resposta não carrega corpo.

              Atenção

              

A exclusão não é permanente. Uma requisição posterior a [GET | Consultar sincronização de grupo LDAP por [id]](/v4-2/docs/api-v2-get-list-an-ldap-group-sync) para o mesmo código de identificação retorna `200 OK` com `active` definido como `false`, não `404`. A plataforma não tem um estado de excluído separado.

---

## Erros

| Código HTTP | Mensagem | Causa possível | Solução |
| --- | --- | --- | --- |
| `403` | `api.permission.denied` | A aplicação não tem permissão para este recurso. | Peça ao administrador para verificar a autorização **Users** da aplicação no A2A. |
| `404` | `api.resource.not_found` | Não existe sincronização com o código de identificação enviado. | Verifique o `id` e reenvie a requisição. |
| `412` | `api.precondition.failed` | O valor de `If-Match` não corresponde à versão armazenada. A sincronização é preservada. | Leia o recurso novamente, confirme se ainda deseja excluí-lo e reenvie a requisição com o novo `ETag`. |
| `428` | `api.precondition.required` | O header `If-Match` está ausente. | Leia o recurso, depois reenvie a requisição com seu `ETag` em `If-Match`. |
| `429` | `rate_limit_exceeded` | A aplicação excedeu sua cota de requisições. | Aguarde o período indicado no header `Retry-After` e reenvie a requisição. |

### Erros de autenticação

| Mensagem | Causa possível | Solução |
| --- | --- | --- |
| `Client authentication failed.` | Falha na autenticação da aplicação com o servidor Segura. | Verifique os parâmetros de autenticação (`Access Token URL`, `Client ID` e `Client secret`) e solicite um novo token de acesso. |
| `Invalid signature` | Falha no reconhecimento da URL da aplicação cliente. | Verifique a URL da aplicação cliente e reenvie a requisição. |
| `No route matched with those values.` | Header de autorização ausente na requisição da API. | Solicite um novo token de acesso. |
| `Request timed out.` | A requisição excedeu o limite de tempo. | Verifique a conectividade entre a origem da requisição e o servidor Segura. |