---
title: "POST | Ativar sincronização de grupo LDAP"
slug: "api-v2-post-activate-ldap-group-sync"
updated: 2026-11-03T14:57:57Z
published: 2026-11-03T14:57:57Z
canonical: "docs.senhasegura.io/api-v2-post-activate-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.

# POST | Ativar sincronização de grupo LDAP

## Descrição

Ative uma sincronização de grupo LDAP inativa na plataforma Segura™. O estado ativo é somente leitura no corpo do recurso, então esta ação é a única forma de defini-lo. Para interromper uma sincronização, acesse [POST | Desativar sincronização de grupo LDAP](/v4-2/docs/api-v2-post-deactivate-ldap-group-sync).

---

## 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).

---

## Requisição

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

### 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 |
| --- | --- | --- |
| `Content-Type` | Sim | Deve ser `application/json`, mesmo que a requisição não carregue corpo. |

              Atenção

              

Envie o header `Content-Type` mesmo com o corpo vazio. Omiti-lo retorna um erro.

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

---

## Resposta

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

A resposta não carrega corpo. Consulte a sincronização com [GET | Consultar sincronização de grupo LDAP por [id]](/v4-2/docs/api-v2-get-list-an-ldap-group-sync) para confirmar o novo estado e obter o `ETag` atualizado.

---

## 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. |
| `409` | `api.resource.conflict.already_active` | A sincronização já está ativa. | Nenhuma ação é necessária. Consulte o recurso para confirmar seu estado. |
| `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. |