---
title: "POST | Criar Agent"
slug: "api-a2a-post-create-agent"
updated: 2026-03-04T12:05:19Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-a2a-post-create-agent"
---

> ## 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 | Criar Agent

Crie um agent para o **Network Connector**.

## Requisitos

- Possuir autorização com permissão de **acesso** e de **leitura e escrita** ao recurso **Sistema**, concedida pelo administrador no **A2A**. .

### Método e endpoint

```
POST /api/system/nc/agent
```

## Parâmetros da Requisição

Os seguintes parâmetros devem ser enviados no **body** da requisição:

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `name` | `string` | Sim | Nome do agent do **Network Connector** a ser criado. |

#### Restrições para o nome do agent

- **Máximo:** 255 caracteres
- **Caracteres permitidos:** a-z, A-Z, 0-9, `-`, `_`, `+`, `=`, `#`, `@`, `$`, `[`, `]`, `(`, `)`, `{`, `}`
- **Nota:** o nome deve ser único e **não pode haver outro agent ativo com o mesmo nome**.

### **Exemplos de Requisição**

```
{
    "name": "agent-example"
}
```

### cURL

```
curl -X POST "https://{URL}/api/system/nc/agent" \
     -H "Authorization: Bearer {TOKEN}" \
     -H "Content-Type: application/json" \
     -d '{"name": "agent-example"}'
```

### Código de status

```
200 OK
```

### Resposta

```
{
  "response": {
    "status": 200,
    "error": false,
    "error_code": 0,
    "message": "Agents fetched"
  },
  "agent": {
    "id": "1",
    "name": "Default",
    "port": "30000",
    "fingerprint": "Zk9YalVUVDRaeWh2b0FKb29uWmhESk44VVdqcEZkSE1qSUZKMkREUjlOdz06Um1kSlUyWlRSbkYwVEZCb2ExUjNRenAzUkhkellXMVJhMWQyWldad1NXSnI="
  }
}
```

## Campos da Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `agent` | `object` | Dados do agent criado. |
| `agent.id` | `int` | Código único de identificação do agent gerado automaticamente pelo Segura®. |
| `agent.name` | `string` | Nome do connector/agent. |
| `agent.port` | `string` | Número da porta automaticamente gerado pelo sistema para conectar o agent à instância. |
| `agent.fingerprint` | `string` | Hash único automaticamente gerado pelo sistema para conectar o agent à porta. **Nota:** Informação sensível. Se a opção **Ativar criptografia de informações sensíveis** estiver habilitada, essa informação será protegida. Para visualizá-la, baixe a chave de descriptografia. Saiba mais em **Primeiros passos com as APIs A2A**. |

## Possíveis Erros

| Código | Mensagem | Causa |
| --- | --- | --- |
| `400` | **Nome do agent inválido** | O nome enviado não atende às restrições definidas. |
| `403` | **Falta de permissão** | O usuário não possui as permissões adequadas para criar um agent. |