IXON AgentServerList API

The AgentServerList API from IXON — 1 operation(s) for agentserverlist.

OpenAPI Specification

ixon-agentserverlist-api-openapi.yml Raw ↑
openapi: 3.0.2
info:
  contact:
    name: IXON B.V.
    url: https://www.ixon.cloud/
    email: support@ixon.cloud
  description: API for the IXON Cloud Platform
  license:
    name: All Rights Reserved
    url: https://www.ixon.cloud/
  title: IXON AccessRecoverList AgentServerList API
  version: 0.1.294
servers:
- description: IXON Cloud platform server
  url: https://portal.ixon.cloud:443/api/
tags:
- name: AgentServerList
paths:
  /agents/{agentId}/servers:
    get:
      tags:
      - AgentServerList
      summary: AgentServerList
      responses:
        '200':
          description: Success response. Data could be an object instead of a list when one value is returned
          content:
            application/json:
              schema:
                type: object
                required:
                - status
                - type
                - data
                properties:
                  status:
                    type: string
                    default: success
                    nullable: false
                  type:
                    type: string
                    nullable: false
                  moreAfter:
                    type: string
                    nullable: true
                  data:
                    nullable: false
                    type: array
                    items:
                      type: object
                      properties:
                        publicId:
                          maxLength: 12
                          minLength: 12
                          nullable: false
                          type: string
                        type:
                          enum:
                          - http
                          - rdp
                          - rtsp
                          - ssh
                          - vnc
                          - websocket
                          nullable: false
                          type: string
                        name:
                          maxLength: 255
                          minLength: 1
                          nullable: false
                          type: string
                        port:
                          maximum: 65535
                          nullable: false
                          type: integer
                          format: int32
                        username:
                          maxLength: 255
                          minLength: 1
                          nullable: true
                          type: string
                        password:
                          maxLength: 255
                          minLength: 1
                          nullable: true
                          type: string
                        hasPassword:
                          nullable: false
                          type: boolean
                        authDomain:
                          maxLength: 253
                          minLength: 4
                          nullable: true
                          pattern: .+(\..[^.]+)
                          type: string
                        landingPage:
                          maxLength: 255
                          minLength: 1
                          nullable: false
                          type: string
                        connectionQuality:
                          enum:
                          - low
                          - normal
                          - high
                          nullable: true
                          type: string
                        readOnly:
                          nullable: true
                          type: boolean
                        vncRightClickOnTouchHold:
                          nullable: false
                          type: boolean
                        vncEncoding:
                          enum:
                          - copyrect
                          - corre
                          - hextile
                          - raw
                          - rre
                          - tight
                          - ultra
                          - ultrazip
                          - zlib
                          - zlibhex
                          - zrle
                          - zywrle
                          nullable: true
                          type: string
                        useSsl:
                          nullable: false
                          type: boolean
                        visibleInMobileApp:
                          nullable: false
                          type: boolean
                        visibleOnWeb:
                          nullable: false
                          type: boolean
                        httpAuthenticationType:
                          enum:
                          - ntlm
                          - basic
                          - digest
                          nullable: true
                          type: string
                        recordSessions:
                          nullable: true
                          type: boolean
                        audience:
                          nullable: false
                          type: object
                          properties:
                            publicId:
                              nullable: false
                              type: string
                        requireAccessApproval:
                          nullable: false
                          type: boolean
                        custom:
                          nullable: false
                          type: object
                        agent:
                          nullable: false
                          type: object
                          properties:
                            publicId:
                              nullable: false
                              type: string
                        device:
                          nullable: false
                          type: object
                          properties:
                            publicId:
                              nullable: false
                              type: string
                        serviceGroup:
                          maxLength: 255
                          minLength: 1
                          nullable: true
                          type: string
                        template:
                          nullable: true
                          type: object
                          properties:
                            publicId:
                              maxLength: 12
                              minLength: 12
                              nullable: false
                              type: string
                            type:
                              enum:
                              - http
                              - rdp
                              - rtsp
                              - ssh
                              - vnc
                              - websocket
                              nullable: false
                              type: string
                            name:
                              maxLength: 255
                              minLength: 1
                              nullable: false
                              type: string
                            port:
                              maximum: 65535
                              nullable: false
                              type: integer
                              format: int32
                            username:
                              maxLength: 255
                              minLength: 1
                              nullable: true
                              type: string
                            password:
                              maxLength: 255
                              minLength: 1
                              nullable: true
                              type: string
                            hasPassword:
                              nullable: false
                              type: boolean
                            authDomain:
                              maxLength: 253
                              minLength: 4
                              nullable: true
                              pattern: .+(\..[^.]+)
                              type: string
                            landingPage:
                              maxLength: 255
                              minLength: 1
                              nullable: false
                              type: string
                            connectionQuality:
                              enum:
                              - low
                              - normal
                              - high
                              nullable: true
                              type: string
                            readOnly:
                              nullable: true
                              type: boolean
                            vncRightClickOnTouchHold:
                              nullable: false
                              type: boolean
                            vncEncoding:
                              enum:
                              - copyrect
                              - corre
                              - hextile
                              - raw
                              - rre
                              - tight
                              - ultra
                              - ultrazip
                              - zlib
                              - zlibhex
                              - zrle
                              - zywrle
                              nullable: true
                              type: string
                            useSsl:
                              nullable: false
                              type: boolean
                            visibleInMobileApp:
                              nullable: false
                              type: boolean
                            visibleOnWeb:
                              nullable: false
                              type: boolean
                            httpAuthenticationType:
                              enum:
                              - ntlm
                              - basic
                              - digest
                              nullable: true
                              type: string
                            recordSessions:
                              nullable: true
                              type: boolean
                            audience:
                              nullable: false
                              type: object
                              properties:
                                publicId:
                                  nullable: false
                                  type: string
                            requireAccessApproval:
                              nullable: false
                              type: boolean
                            custom:
                              nullable: false
                              type: object
        4XX:
          $ref: '#/components/responses/4XXErrorResponse'
      parameters:
      - $ref: '#/components/parameters/apiVersion'
      - $ref: '#/components/parameters/apiApplication'
      - $ref: '#/components/parameters/apiCompany'
      - $ref: '#/components/parameters/apiBrandingOptional'
      - $ref: '#/components/parameters/fieldsParameter'
      - $ref: '#/components/parameters/filtersParameter'
      - required: true
        name: agentId
        in: path
        schema:
          type: string
      security:
      - bearerToken: []
    post:
      tags:
      - AgentServerList
      summary: AgentServerList
      responses:
        '201':
          description: Success response. Data could be an object instead of a list when one value is returned
          content:
            application/json:
              schema:
                type: object
                required:
                - status
                - type
                - data
                properties:
                  status:
                    type: string
                    default: success
                    nullable: false
                  type:
                    type: string
                    nullable: false
                  moreAfter:
                    type: string
                    nullable: true
                  data:
                    nullable: false
                    type: array
                    items:
                      type: object
                      properties:
                        publicId:
                          maxLength: 12
                          minLength: 12
                          nullable: false
                          type: string
                      required:
                      - publicId
        4XX:
          $ref: '#/components/responses/4XXErrorResponse'
      parameters:
      - $ref: '#/components/parameters/apiVersion'
      - $ref: '#/components/parameters/apiApplication'
      - $ref: '#/components/parameters/apiCompany'
      - $ref: '#/components/parameters/apiBrandingOptional'
      - required: true
        name: agentId
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  type:
                    enum:
                    - http
                    - rdp
                    - rtsp
                    - ssh
                    - vnc
                    - websocket
                    nullable: false
                    type: string
                  template:
                    nullable: false
                    type: object
                    properties:
                      publicId:
                        nullable: false
                        type: string
                  name:
                    maxLength: 255
                    minLength: 1
                    nullable: false
                    type: string
                  port:
                    maximum: 65535
                    nullable: false
                    type: integer
                    format: int32
                  device:
                    nullable: false
                    type: object
                    properties:
                      publicId:
                        nullable: false
                        type: string
                  serviceGroup:
                    maxLength: 255
                    minLength: 1
                    nullable: true
                    type: string
                  username:
                    maxLength: 255
                    minLength: 1
                    nullable: true
                    type: string
                  password:
                    maxLength: 255
                    minLength: 1
                    nullable: true
                    type: string
                  authDomain:
                    maxLength: 253
                    minLength: 4
                    nullable: true
                    pattern: .+(\..[^.]+)
                    type: string
                  landingPage:
                    maxLength: 255
                    minLength: 1
                    nullable: false
                    type: string
                  connectionQuality:
                    enum:
                    - low
                    - normal
                    - high
                    nullable: true
                    type: string
                  readOnly:
                    nullable: true
                    type: boolean
                  vncRightClickOnTouchHold:
                    nullable: false
                    type: boolean
                  vncEncoding:
                    enum:
                    - copyrect
                    - corre
                    - hextile
                    - raw
                    - rre
                    - tight
                    - ultra
                    - ultrazip
                    - zlib
                    - zlibhex
                    - zrle
                    - zywrle
                    nullable: true
                    type: string
                  useSsl:
                    nullable: false
                    type: boolean
                  visibleInMobileApp:
                    nullable: false
                    type: boolean
                  visibleOnWeb:
                    nullable: false
                    type: boolean
                  httpAuthenticationType:
                    enum:
                    - ntlm
                    - basic
                    - digest
                    nullable: true
                    type: string
                  recordSessions:
                    nullable: true
                    type: boolean
                  audience:
                    nullable: false
                    type: object
                    properties:
                      publicId:
                        nullable: false
                        type: string
                  requireAccessApproval:
                    nullable: false
                    type: boolean
                  custom:
                    nullable: false
                    type: object
                required:
                - type
                - name
                - port
                - device
                - audience
        description: You can give one item or a list of items
      security:
      - bearerToken: []
    patch:
      tags:
      - AgentServerList
      summary: AgentServerList
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                type: object
                required:
                - status
                - type
                - data
                properties:
                  status:
                    type: string
                    default: success
                    nullable: false
                  type:
                    type: string
                    nullable: false
                  data:
                    type: object
                    nullable: true
        4XX:
          $ref: '#/components/responses/4XXErrorResponse'
      parameters:
      - $ref: '#/components/parameters/apiVersion'
      - $ref: '#/components/parameters/apiApplication'
      - $ref: '#/components/parameters/apiCompany'
      - $ref: '#/components/parameters/apiBrandingOptional'
      - required: true
        name: agentId
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  publicId:
                    maxLength: 12
                    minLength: 12
                    nullable: false
                    type: string
                  device:
                    nullable: false
                    type: object
                    properties:
                      publicId:
                        nullable: false
                        type: string
                  serviceGroup:
                    maxLength: 255
                    minLength: 1
                    nullable: true
                    type: string
                  name:
                    maxLength: 255
                    minLength: 1
                    nullable: false
                    type: string
                  port:
                    maximum: 65535
                    nullable: false
                    type: integer
                    format: int32
                  username:
                    maxLength: 255
                    minLength: 1
                    nullable: true
                    type: string
                  password:
                    maxLength: 255
                    minLength: 1
                    nullable: true
                    type: string
                  authDomain:
                    maxLength: 253
                    minLength: 4
                    nullable: true
                    pattern: .+(\..[^.]+)
                    type: string
                  landingPage:
                    maxLength: 255
                    minLength: 1
                    nullable: false
                    type: string
                  connectionQuality:
                    enum:
                    - low
                    - normal
                    - high
                    nullable: true
                    type: string
                  readOnly:
                    nullable: true
                    type: boolean
                  vncRightClickOnTouchHold:
                    nullable: false
                    type: boolean
                  vncEncoding:
                    enum:
                    - copyrect
                    - corre
                    - hextile
                    - raw
                    - rre
                    - tight
                    - ultra
                    - ultrazip
                    - zlib
                    - zlibhex
                    - zrle
                    - zywrle
                    nullable: true
                    type: string
                  useSsl:
                    nullable: false
                    type: boolean
                  visibleInMobileApp:
                    nullable: false
                    type: boolean
                  visibleOnWeb:
                    nullable: false
                    type: boolean
                  httpAuthenticationType:
                    enum:
                    - ntlm
                    - basic
                    - digest
                    nullable: true
                    type: string
                  recordSessions:
                    nullable: true
                    type: boolean
                  audience:
                    nullable: false
                    type: object
                    properties:
                      publicId:
                        nullable: false
                        type: string
                  requireAccessApproval:
                    nullable: false
                    type: boolean
                  custom:
                    nullable: false
                    type: object
                required:
                - publicId
        description: You can give one item or a list of items
      security:
      - bearerToken: []
    delete:
      tags:
      - AgentServerList
      summary: AgentServerList
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                type: object
                required:
                - status
                - type
                - data
                properties:
                  status:
                    type: string
                    default: success
                    nullable: false
                  type:
                    type: string
                    nullable: false
                  data:
                    type: object
                    nullable: true
        4XX:
          $ref: '#/components/responses/4XXErrorResponse'
      parameters:
      - $ref: '#/components/parameters/apiVersion'
      - $ref: '#/components/parameters/apiApplication'
      - $ref: '#/components/parameters/apiCompany'
      - $ref: '#/components/parameters/apiBrandingOptional'
      - required: true
        name: agentId
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  publicId:
                    maxLength: 12
                    minLength: 12
                    nullable: false
                    type: string
                required:
                - publicId
        description: You can give one item or a list of items
      security:
      - bearerToken: []
components:
  parameters:
    apiApplication:
      required: true
      description: Get your Application ID via support@ixon.cloud
      name: Api-Application
      in: header
      schema:
        type: string
        pattern: ^[0-9a-zA-Z]{12}$
    apiVersion:
      required: true
      description: Version of the API to use
      name: Api-Version
      in: header
      schema:
        type: integer
        format: int32
        enum:
        - 2
    apiBrandingOptional:
      required: false
      description: Domain that provides the branding
      name: Api-Branding
      in: header
      schema:
        type: string
        pattern: .+(\..[^.]+)
    fieldsParameter:
      required: false
      description: 'Fields to select. Use "*" for all the top-level fields. Or check the "Success response" below for other fields.


        To get the fields of a subresource do subresource.field or for multiple fields of one subresource do subresource(field,field)'
      name: fields
      in: query
      schema:
        type: array
        items:
          type: string
    filtersParameter:
      required: false
      description: 'Filter the returned item(s). Format: operator(column,val)


        Possible operators are: lt, less, lte, lessorequal, eq, equals, ne, differs, gt, greater, gte, greaterorequal, in, ni, isnull, isnotnull, between, contains.


        Example: eq(publicId,"publicId_val")'
      name: filters
      in: query
      schema:
        type: array
        items:
          type: string
    apiCompany:
      required: true
      description: PublicId of the company
      name: Api-Company
      in: header
      schema:
        type: string
        pattern: ^(\d{4}-){4}\d{4}$
  responses:
    4XXErrorResponse:
      description: 4XX error response
      content:
        application/json:
          schema:
            type: object
            required:
            - status
            - type
            - data
            properties:
              status:
                type: string
                default: error
                nullable: false
              type:
                type: string
                default: Error
                nullable: false
              data:
                nullable: false
                type: array
                items:
                  $ref: '#/components/schemas/4XXErrorSchema'
  schemas:
    4XXErrorSchema:
      type: object
      properties:
        message:
          nullable: false
          type: string
        propertyName:
          nullable: true
          type: string
        listIndex:
          nullable: true
          type: integer
          format: int32
      required:
      - message
  securitySchemes:
    bearerToken:
      type: http
      description: Bearer token created by the endpoint "POST AccessTokenList"
      scheme: bearer
x-samples-languages:
- curl
- ruby
- javascript
- python
- powershell