Products Solutions Developer Pricing Get For Free Download Sign in Sign up
Show topics

Vhost

Returns detailed information about a specific virtual host.

Request

Property Value
Method GET
URL /api/server/settings/vhosts/{vhostId}
Content-Type application/json
Authentication Bearer Token

Path Parameters

Parameter Type Required Description
vhostId integer Yes Unique identifier of the VHost

Response

Status Codes

Code Description
200 Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing token
404 Not Found - VHost does not exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error

Successful Response (200)

{
  "data": {
    "id": 3,
    "attributes": {
      "host": {
        "editable": true,
        "value": "127.0.0.1"
      },
      "port": {
        "editable": true,
        "value": 8093
      },
      "protocols": {
        "editable": true,
        "value": ["HTTP"]
      },
      "isSSL": {
        "editable": true,
        "value": true
      },
      "certificatePath": {
        "editable": true,
        "value": "/path/to/certificate.p12"
      },
      "certificatePassword": {
        "masked": true,
        "value": "p****d"
      },
      "isControlPanel": {
        "editable": true,
        "value": true
      }
    }
  },
  "meta": {
    "executionTime": 0,
    "generatedAt": 1764854328235
  }
}

Response Body

VHost

Parameter Type Description
data.id integer Unique identifier of the VHost
data.attributes.host.value string Host binding
data.attributes.host.editable boolean Indicates if the field can be modified
data.attributes.host.lockedBy string Locked by environment variable (if present)
data.attributes.port.value integer Port number
data.attributes.port.editable boolean Indicates if the field can be modified
data.attributes.port.lockedBy string Locked by environment variable (if present)
data.attributes.protocols.value string[] Enabled protocols
data.attributes.protocols.editable boolean Indicates if the field can be modified
data.attributes.protocols.lockedBy string Locked by environment variable (if present)
data.attributes.isSSL.value boolean SSL enabled
data.attributes.isSSL.editable boolean Indicates if the field can be modified
data.attributes.isSSL.lockedBy string Locked by environment variable (if present)
data.attributes.certificatePath.value string Path to SSL certificate
data.attributes.certificatePath.editable boolean Indicates if the field can be modified
data.attributes.certificatePath.lockedBy string Locked by environment variable (if present)
data.attributes.certificatePassword.value string SSL certificate password (masked)
data.attributes.certificatePassword.masked boolean Indicates if the value is masked
data.attributes.isControlPanel.value boolean Control panel endpoint
data.attributes.isControlPanel.editable boolean Indicates if the field can be modified
data.attributes.isControlPanel.lockedBy string Locked by environment variable (if present)

Metadata

Parameter Type Description
meta.executionTime integer Request processing time in milliseconds
meta.generatedAt integer Response generation timestamp (Unix timestamp in ms)

Error Responses

VHost Not Found (404)

{
  "message": "VHost Entity not found"
}

Error Response Body

Parameter Type Description
message string Human-readable error message