---
title: "AgentServerList"
method: POST
path: "/agents/{agentId}/servers"
tags: ["AgentServerList"]
---

# AgentServerList

`POST /agents/{agentId}/servers`

## Path parameters

- `agentId` string, required

## Headers

- `Api-Version` 2, required
- `Api-Application` string, required
- `Api-Company` string, required
- `Api-Branding` string

## Request body

- object[]
  - `type` 'http' | 'rdp' | 'rtsp' | 'ssh' | 'vnc' | 'websocket', required
  - `template` object
    - `publicId` string
  - `name` string, required
  - `port` integer, required
  - `device` object, required
    - `publicId` string
  - `serviceGroup` string, nullable
  - `username` string, nullable
  - `password` string, nullable
  - `authDomain` string, nullable
  - `landingPage` string
  - `connectionQuality` 'low' | 'normal' | 'high', nullable
  - `readOnly` boolean, nullable
  - `vncRightClickOnTouchHold` boolean
  - `vncEncoding` 'copyrect' | 'corre' | 'hextile' | 'raw' | 'rre' | 'tight' | 'ultra' | 'ultrazip' | 'zlib' | 'zlibhex' | 'zrle' | 'zywrle', nullable
  - `useSsl` boolean
  - `visibleInMobileApp` boolean
  - `visibleOnWeb` boolean
  - `httpAuthenticationType` 'ntlm' | 'basic' | 'digest', nullable
  - `flags` string[]
  - `recordSessions` boolean, nullable
  - `audience` object, required
    - `publicId` string
  - `requireAccessApproval` boolean
  - `custom` object

## Response `201`

Success response. Data could be an object instead of a list when one value is returned

- object
  - `status` string, required
  - `type` string, required
  - `moreAfter` string, nullable
  - `data` object[], required
    - `publicId` string, required

## Other responses

- `4XX` — 4XX error response

---

[API](https://skmtc.net/ixon/apis/ixon-api.md) · [All operations](https://skmtc.net/ixon/apis/ixon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ixon/ixon-api/versions/7875dc33d41f/schema)