Sites

PreviousTests a URL that leads to a client IP detection service NextStatus

Was this helpful?

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

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

GET /api/Site/{id} HTTP/1.1
Host: 
Accept: */*

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-05-23T11:19:57.462Z",
  "timeLastMod": "2025-05-23T11:19:57.462Z",
  "name": "text",
  "licensingSite": true,
  "enableHttpHostAttackProtection": true
}

Delete

delete

Delete a Site from the RAS farm.

Path parameters

idinteger · int32Required

ID of the Site to be deleted

Responses

204

No Content

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

delete

DELETE /api/Site/{id} HTTP/1.1
Host: 
Accept: */*

No content

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

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

GET /api/Site HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-05-23T11:19:57.462Z",
    "timeLastMod": "2025-05-23T11:19:57.462Z",
    "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

401

Unauthorized

application/json; api-version=1.0

409

Conflict

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-05-23T11:19:57.462Z",
  "timeLastMod": "2025-05-23T11:19:57.462Z",
  "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

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

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