---
title: "POST | Ativar agente do Network Connector"
slug: "api-v2-post-activate-network-connector-agent"
updated: 2026-10-14T16:40:06Z
published: 2026-10-14T16:40:06Z
canonical: "docs.senhasegura.io/api-v2-post-activate-network-connector-agent"
stale: true
---

> ## 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 agente do Network Connector

## Descrição

Ative um agente desativado do Network Connector. O agente volta na mesma porta e mantém o fingerprint.

Depois da ativação, é possível vincular dispositivos ao agente de novo pelo campo `network_connector_id`.

---

## Pré-requisitos

- Uma aplicação com a **Permissão do recurso PAM** definida como **Leitura e escrita**, concedida pelo administrador no A2A. Para mais informações, acesse [Como gerenciar autorizações no A2A API v2](/v4-2/docs/pt/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/pt/how-to-authenticate-an-application-in-a2a).
- Um agente desativado. Ativar um agente que já está ativo retorna `409`.

---

## Requisição

`POST` `/api/v2/platform/network-connector/agents/{agent_id}/activate`

### Parâmetros de caminho

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `agent_id` | integer | Sim | Código de identificação único do agente. Aceita apenas dígitos. Para encontrar os agentes desativados, acesse [GET \| Listar todos os agentes do Network Connector](/v4-2/docs/pt/api-v2-get-list-all-network-connector-agents) com `active=false`. |

Esta ação não tem corpo de requisição e não exige o cabeçalho `If-Match`.

---

### Exemplo de requisição

`POST` `{{url}}/api/v2/platform/network-connector/agents/12/activate`

---

## Resposta

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

A resposta não tem corpo. O cabeçalho `ETag` traz o novo estado do agente.

---

## Erros

| Código HTTP | Mensagem | Causa possível | Solução |
| --- | --- | --- | --- |
| `403` | `api.auth.insufficient_permission` | A **Permissão do recurso PAM** da aplicação é **Apenas leitura**. | Peça ao administrador para definir a **Permissão do recurso PAM** como **Leitura e escrita** no A2A. |
| `404` | `api.resource.not_found` | O agente não existe. | Verifique o código de identificação enviado no caminho. |
| `404` | `api.route.not_found` | O valor de `agent_id` não é formado apenas por dígitos. | Envie o código de identificação do agente usando apenas dígitos. |
| `409` | `api.resource.conflict.already_active` | O agente já está ativo. | Nenhuma ação é necessária. O agente já está no estado pedido. |

Para erros de autenticação, limites de requisição e o formato da resposta de erro, acesse [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/pt/api-v2-conventions-and-shared-behaviors).

### Exemplo de resposta de erro

`409` o agente já está ativo:

```
{
    "code": "api.resource.conflict.already_active",
    "message": "Network connector agent is already active.",
    "details": null
}
```

---

## Documentos relacionados

- [POST | Desativar agente do Network Connector](/v4-2/docs/pt/api-v2-post-deactivate-network-connector-agent)
- [GET | Listar todos os agentes do Network Connector](/v4-2/docs/pt/api-v2-get-list-all-network-connector-agents)
- [GET | Listar um agente do Network Connector por [id]](/v4-2/docs/pt/api-v2-get-list-a-network-connector-agent)
- [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/pt/api-v2-conventions-and-shared-behaviors)