Open a jail console WebSocket

GET

/jail/{ctid}/console

const url = 'https://sylve.lan:8181/api/jail/1/console?auth=example';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://sylve.lan:8181/api/jail/1/console?auth=example' \
  --header 'Authorization: <Authorization>'

Validate that the jail console is available and upgrade to an authenticated interactive WebSocket session

Authorizations

BearerAuth

Parameters

Path Parameters

ctid

required

integer

>= 1

Jail CTID

Query Parameters

auth

required

string

Hex-encoded WebSocket authentication payload

Responses

101

Switching Protocols

string

400

Bad Request

object

data

error

string

message

string

status

string

401

Unauthorized

object

data

error

string

message

string

status

string

403

Forbidden

object

data

error

string

message

string

status

string

404

Jail Not Found

object

data

error

string

message

string

status

string

409

Conflict

object

data

error

string

message

string

status

string

500

Internal Server Error

object

data

error

string

message

string

status

string

503

Service Unavailable

object

data

error

string

message

string

status

string