Skip to content
SYLVE

Queue a Jail lifecycle action

POST
/jail/{ctid}/actions/{action}
curl --request POST \
  --url https://sylve.lan:8181/api/jail/1/actions/start \
  --header 'Authorization: <Authorization>'

Queue a start, stop, or restart action for a jail by its CTID

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
ctid
required
integer
>= 1

Jail CTID

action
required
string
Allowed values: start stop restart

Lifecycle action

Responses

Section titled “Responses”

202

Section titled “202”

Accepted

Media typeapplication/json
object
data
object
action
string
ctId
integer
outcome
string
taskId
integer
error
string
message
string
status
string
Examplegenerated
{
  "data": {
    "action": "example",
    "ctId": 1,
    "outcome": "example",
    "taskId": 1
  },
  "error": "example",
  "message": "example",
  "status": "example"
}

400

Section titled “400”

Bad Request

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

403

Section titled “403”

Forbidden

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

404

Section titled “404”

Not Found

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

409

Section titled “409”

Conflict

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

500

Section titled “500”

Internal Server Error

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}