---
title: "POST | Ativar dispositivo"
slug: "api-v2-post-activate-device"
updated: 2026-11-03T14:47:51Z
published: 2026-11-03T14:47:51Z
canonical: "docs.senhasegura.io/api-v2-post-activate-device"
---

> ## 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 dispositivo

## Descrição

Ative um dispositivo cadastrado no PAM Core utilizando a API v2. A ativação restabelece o dispositivo como alvo operacional, permitindo novamente operações de escrita e sessões.

              Atenção

              

A ativação se aplica **apenas ao dispositivo**. As credenciais desativadas por um [POST | Desativar dispositivo (v2)](/v4-2/docs/api-v2-post-deactivate-device) anterior **não** são reativadas: reativá-las é responsabilidade do integrador e precisa ser feito explicitamente pela API de credenciais ou pela interface web.

---

## Pré-requisitos

- Autorização com permissão de **escrita** para o PAM Core, 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 dispositivo inativo. Ativar um dispositivo que já está ativo retorna `409`.

---

## Requisição

`POST` `/api/v2/platform/devices/{id}/activate`

              Info

              

Este endpoint faz parte da superfície da API v2 do A2A e está disponível a partir da versão 4.2.9 do Segura™. Os dispositivos são servidos pelo caminho base `/api/v2/platform`, e não por `/api/v2/pam` como os demais recursos v2. O equivalente v1 está documentado em [PUT | Ativar dispositivo](/v4-2/docs/api-put-enable-device).

### Parâmetros de caminho

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | integer | Sim | Código de identificação único do dispositivo. **Nota:** este valor é atribuído pelo Segura™ em [POST \| Criar dispositivo (v2)](/v4-2/docs/api-v2-post-create-device). |

Esta ação não recebe corpo de requisição e não exige o cabeçalho `If-Match` requerido por [PUT | Atualizar dispositivo (v2)](/v4-2/docs/api-v2-put-update-device) e [PATCH | Atualizar dispositivo (v2)](/v4-2/docs/api-v2-patch-update-device).

---

### Exemplo de requisição

`POST` `{{url}}/api/v2/platform/devices/55/activate`

---

## Resposta

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

A resposta não tem corpo. Para confirmar o novo estado, consulte o dispositivo com [GET | Listar um dispositivo (v2)](/v4-2/docs/api-v2-get-list-a-device): o campo `device.active` retorna `true`, e `meta.actions` passa a expor apenas `deactivate`.

---

## Erros

| Código HTTP | Mensagem | Causa possível | Solução |
| --- | --- | --- | --- |
| `401` | `api.auth.token.invalid` | O token de acesso está ausente ou expirou. | Solicite um novo token de acesso. |
| `403` | `api.permission.denied` | A autorização não tem permissão de escrita para os recursos do PAM Core. | Peça ao administrador para verificar as permissões da autorização no A2A e gere um novo token. |
| `404` | `api.resource.not_found` | O dispositivo não existe ou pertence a outro tenant. | Verifique o código de identificação enviado no caminho. |
| `409` | `api.resource.conflict.already_active` | O dispositivo já está ativo. | Nenhuma ação é necessária, o dispositivo já está no estado solicitado. |
| `429` | `rate_limit_exceeded` | O limite de requisições foi excedido. | Aguarde o número de segundos indicado no cabeçalho `Retry-After` e tente novamente. |
| `500` | `api.internal.error` | Erro interno do servidor. | Entre em contato com a equipe de suporte da Segura™. |

### Exemplo de resposta de erro

`409` o dispositivo já está ativo:

```
{
    "error": {
        "code": "api.resource.conflict.already_active",
        "message": "Device is already active."
    }
}
```

### 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.` | Cabeçalho 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™. |

---

## Documentos relacionados

- [POST | Desativar dispositivo (v2)](/v4-2/docs/api-v2-post-deactivate-device)
- [GET | Listar um dispositivo (v2)](/v4-2/docs/api-v2-get-list-a-device)
- [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/api-v2-conventions-and-shared-behaviors)
- [Como gerenciar autorizações no A2A API v2](/v4-2/docs/api-v2-how-to-manage-authorizations-in-a2a)