POST | Create agents

Create an agent for the Network Connector.

Requirements

• Have authorization with access and read and write permissions to the System resource, granted by the administrator in A2A.

Method and endpoint

POST /api/system/nc/agent

Request parameters

The following parameters must be sent in the request body:

Agent name restrictions

• Maximum: 255 characters
• Allowed characters: a-z, A-Z, 0-9, -, _, +, =, #, @, $, [, ], (, ), {, }
• Note: The name must be unique, and there cannot be another active agent with the same name.

Request Example

{
    "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"}'

Status code

201 CREATED

Response

{
  "response": {
    "status": 201,
    "error": false,
    "error_code": 0,
    "message": "Agent created successfully."
  },
  "agent": {
    "id": "1",
    "name": "Default",
    "port": "30000",
    "fingerprint": "Zk9YalVUVDRaeWh2b0FKb29uWmhESk44VVdqcEZkSE1qSUZKMkREUjlOdz06Um1kSlUyWlRSbkYwVEZCb2ExUjNRenAzUkhkellXMVJhMWQyWldad1NXSnI="
  }
}

Response fields

Possible errors