---
title: "POST | Ativar grupo de usuários"
slug: "api-v2-post-activate-user-group"
updated: 2026-09-29T16:24:38Z
published: 2026-09-29T16:24:38Z
canonical: "docs.senhasegura.io/api-v2-post-activate-user-group"
---

> ## 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 grupo de usuários

## Descrição

Ative um grupo de usuários inativo. A ativação é uma ação dedicada e não um campo, então o estado `active` não pode ser alterado por [PUT | Atualizar grupo de usuários](/v4-2/docs/api-v2-put-update-user-group) ou [PATCH | Atualizar parcialmente grupo de usuários](/v4-2/docs/api-v2-patch-update-user-group).

Uma atualização enviada a um grupo inativo é recusada com `409` `api.resource.inactive`, então ative o grupo antes quando precisar editá-lo.

---

## Pré-requisitos

- Uma aplicação com a autorização **Users** concedida pelo administrador no A2A. Para mais informações, acesse [Como gerenciar autorizações no A2A API v2](/v4-2/docs/api-v2-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 A2A](/v4-2/docs/how-to-authenticate-an-application-in-a2a).

---

## Requisição

`POST` `/api/v2/iam/user-groups/{id}/activate`

Esta ação não recebe corpo de requisição.

### Parâmetros de path

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | integer | Sim | Código de identificação único do grupo de usuários. |

---

### Exemplo de requisição

`POST` `{{url}}/api/v2/iam/user-groups/7/activate`

---

## Resposta

```
HTTP/1.1 204 No Content
X-Request-Id: 7f3c1a90-2c4e-4b1a-9f5e-0a2b7c9d1e34
```

Uma ativação bem-sucedida não retorna corpo. Para confirmar o novo estado, acesse [GET | Consultar um grupo de usuários](/v4-2/docs/api-v2-get-list-a-user-group).

              Atenção

              

A ativação não restaura os vínculos de membro. Desativar ou excluir um grupo remove todos os seus membros, então adicione-os novamente após a ativação. Para mais informações, acesse [POST | Adicionar membros a um grupo de usuários](/v4-2/docs/api-v2-post-add-user-group-members).

---

## Erros

| Código HTTP | Mensagem | Possível causa | Solução |
| --- | --- | --- | --- |
| `401` | `api.auth.unauthorized` | O token de acesso está ausente, inválido ou expirou. | Solicite um novo token de acesso. |
| `404` | `api.resource.not_found` | O grupo de usuários não existe, ou está fora do escopo da autorização. | Verifique o código de identificação e o escopo da autorização. |
| `409` | `api.resource.conflict.already_active` | O grupo de usuários já está ativo. | Nenhuma ação é necessária. |
| `429` | `api.rate_limit_exceeded` | O limite de requisições foi excedido. | Aguarde o número de segundos retornado no cabeçalho `Retry-After` e tente novamente. |

Para as mensagens de erro de autenticação e a política de `403` versus `404`, acesse [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/api-v2-conventions-and-shared-behaviors).