Sites

List

get

Retrieve the list of all the available Sites.

Query parameters
NamestringOptional

Filter the result by name (optional)

Responses
200
Success
application/json; api-version=1.0
get
GET /api/Site HTTP/1.1
Host: 
Accept: */*
[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-07-08T06:55:31.154Z",
    "timeLastMod": "2025-07-08T06:55:31.154Z",
    "name": "text",
    "licensingSite": true,
    "enableHttpHostAttackProtection": true
  }
]

Create

post

Add a new site to the RAS farm.

Query parameters
noInstallbooleanOptional

If this parameter is included, the Connection Broker software will not be installed on the target server. You may use this option if the server already has the Connection Broker installed.

usernamestringOptional

A username to log in to the target server and push install the Connection Broker on it. You must also specify the Password parameter. If you've included the NoInstall parameter, you don't have to include the Username and Password parameters.

passwordstringOptional

The password for the user specified in the Username parameter.

noRestartbooleanOptional

Specifies not to add firewall rules to allow the RAS Agent to communicate. If this parameter is omitted, the firewall rules will not be added.

noFireWallRulesbooleanOptional

Specifies not to restart the server after the RAS agents are installed. If this parameter is omitted, the server will be restarted if required.

Body

Create a new Site

serverstring | nullableRequired

The target server FQDN or IP address.

namestring | nullableOptional

The name you want to use for the new site.

Responses
201
Created
application/json; api-version=1.0
post
POST /api/Site HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 31

{
  "server": "text",
  "name": "text"
}
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-07-08T06:55:31.154Z",
  "timeLastMod": "2025-07-08T06:55:31.154Z",
  "name": "text",
  "licensingSite": true,
  "enableHttpHostAttackProtection": true
}

Get

get

Retrieve a Site.

Path parameters
idinteger · int32Required

ID of the Site to be retrieved

Responses
200
Success
application/json; api-version=1.0
get
GET /api/Site/{id} HTTP/1.1
Host: 
Accept: */*
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-07-08T06:55:31.154Z",
  "timeLastMod": "2025-07-08T06:55:31.154Z",
  "name": "text",
  "licensingSite": true,
  "enableHttpHostAttackProtection": true
}

Update

put

Modify the Site properties.

Path parameters
idinteger · int32Required

ID of the Site to be updated

Body

Update Site settings

namestring | nullableOptional

A new name to assign to the site.

enableHttpHostAttackProtectionboolean | nullableOptional

Whether Http Host Attack protection is enabled for this site or not.

Responses
204
No Content
put
PUT /api/Site/{id} HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 53

{
  "name": "text",
  "enableHttpHostAttackProtection": true
}

No content

Delete

delete

Delete a Site from the RAS farm.

Path parameters
idinteger · int32Required

ID of the Site to be deleted

Responses
204
No Content
delete
DELETE /api/Site/{id} HTTP/1.1
Host: 
Accept: */*

No content

Was this helpful?