---
title: "Create new agent in service"
method: POST
path: "/agents/"
tags: ["Agents"]
---

# Create new agent in service

`POST /agents/`

## Request body

- PrivateAgentInfo
  - `arch` '386' | 'amd64', required
  - `name` string, required
  - `os` 'windows' | 'linux' | 'darwin', required

## Response `201`

agent created successful

- object
  - `data` object
    - `auth_status` 'authorized' | 'unauthorized' | 'blocked', required
    - `connected_date` string
    - `created_date` string
    - `deleted_at` string
    - `description` string, required
    - `group_id` integer
    - `hash` string, required
    - `id` integer
    - `info` ModelsAgentInfo, required
      - `net` ModelsAgentNet, required
        - `hostname` string, required
        - `ips` string[], required
      - `os` ModelsAgentOS, required
        - `arch` '386' | 'amd64', required
        - `name` string, required
        - `type` 'windows' | 'linux' | 'darwin', required
      - `tags` string[], required
      - `users` ModelsAgentUser[], required
        - `groups` string[], required
        - `name` string, required
    - `ip` string, required
    - `status` 'connected' | 'disconnected', required
    - `updated_at` string
    - `version` string, required
  - `status` string

## Other responses

- `400` — invalid agent info
- `403` — creating agent not permitted
- `500` — internal error on creating agent

---

[API](https://skmtc.net/vxcontrol/apis/soldr-swagger-api.md) · [All operations](https://skmtc.net/vxcontrol/apis/soldr-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vxcontrol/soldr-swagger-api/revisions/ac519ec936b3/schema)