Introduction

VitoDeploy's API documentation.

Base URL: https://your-vito-url

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer YOUR-API-KEY".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting here

cron-jobs

list

requires authentication

Get all cron jobs.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/cron-jobs" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/cron-jobs"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "server_id": null,
            "command": "ls -la",
            "user": "root",
            "frequency": "* * * * *",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "command": "ls -la",
            "user": "root",
            "frequency": "* * * * *",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/cron-jobs

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

create

requires authentication

Create a new cron job.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/cron-jobs" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"command\": \"sit\",
    \"user\": \"root\",
    \"frequency\": \"* * * * *\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'command' => 'sit',
            'user' => 'root',
            'frequency' => '* * * * *',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/cron-jobs"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "command": "sit",
    "user": "root",
    "frequency": "* * * * *"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "command": "ls -la",
    "user": "root",
    "frequency": "* * * * *",
    "status": "ready",
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/cron-jobs

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

Body Parameters

command string

Example: sit

user string

Example: root

Must be one of:

root
vito

frequency string

Frequency of the cron job. Example: * * * * *

show

requires authentication

Get a cron job by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/cron-jobs/13" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs/13';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/cron-jobs/13"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "command": "ls -la",
    "user": "root",
    "frequency": "* * * * *",
    "status": "ready",
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/cron-jobs/{cronJob_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

cronJob_id integer

The ID of the cronJob. Example: 13

delete

requires authentication

Delete cron job.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/cron-jobs/16" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs/16';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/cron-jobs/16"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/cron-jobs/{cronJob_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

cronJob_id integer

The ID of the cronJob. Example: 16

database-users

list

requires authentication

Get all database users.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/database-users" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/database-users"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "server_id": null,
            "username": "imurray",
            "databases": [],
            "host": "%",
            "status": null,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "username": "raleigh.heidenreich",
            "databases": [],
            "host": "%",
            "status": null,
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/database-users

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

create

requires authentication

Create a new database user.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/database-users" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"username\": \"ut\",
    \"password\": \"L&1)4X-w>&T=:\'Y2#x\",
    \"host\": \"%\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'username' => 'ut',
            'password' => 'L&1)4X-w>&T=:\'Y2#x',
            'host' => '%',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/database-users"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "username": "ut",
    "password": "L&1)4X-w>&T=:'Y2#x",
    "host": "%"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "username": "kbernhard",
    "databases": [],
    "host": "%",
    "status": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/database-users

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

Body Parameters

username string

Example: ut

password string

Example: L&1)4X-w>&T=:'Y2#x

host string

Host, if it is a remote user. Example: %

show

requires authentication

Get a database user by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/database-users/8" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users/8';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/database-users/8"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "username": "lavada.casper",
    "databases": [],
    "host": "%",
    "status": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

databaseUser_id integer

The ID of the databaseUser. Example: 8

link

requires authentication

Link to databases

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/database-users/3/link" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"databases\": \"laboriosam\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users/3/link';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'databases' => 'laboriosam',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/database-users/3/link"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "databases": "laboriosam"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "username": "ojerde",
    "databases": [],
    "host": "%",
    "status": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}/link

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

databaseUser_id integer

The ID of the databaseUser. Example: 3

Body Parameters

databases string

Array of database names to link to the user. Example: laboriosam

delete

requires authentication

Delete database user.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/database-users/8" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users/8';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/database-users/8"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

databaseUser_id integer

The ID of the databaseUser. Example: 8

databases

list

requires authentication

Get all databases.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/databases" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/databases';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/databases"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "server_id": null,
            "name": "fkrajcik",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "name": "critchie",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/databases

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

create

requires authentication

Create a new database.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/databases" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"esse\",
    \"charset\": \"ut\",
    \"collation\": \"labore\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/databases';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'esse',
            'charset' => 'ut',
            'collation' => 'labore',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/databases"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "esse",
    "charset": "ut",
    "collation": "labore"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "name": "cory33",
    "status": "ready",
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/databases

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

Body Parameters

name string

Example: esse

charset string

Example: ut

collation string

Example: labore

show

requires authentication

Get a database by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/databases/9" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/databases/9';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/databases/9"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "name": "walter.jacey",
    "status": "ready",
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/databases/{id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

id integer

The ID of the database. Example: 9

delete

requires authentication

Delete database.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/databases/16" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/databases/16';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/databases/16"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/databases/{database_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

database_id integer

The ID of the database. Example: 16

firewall-rules

list

requires authentication

Get all firewall rules.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/firewall-rules" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "name": "optio",
            "server_id": null,
            "type": "allow",
            "protocol": "tcp",
            "port": 52674,
            "source": "142.10.115.135",
            "mask": 24,
            "note": "test",
            "status": null,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "name": "dolores",
            "server_id": null,
            "type": "allow",
            "protocol": "tcp",
            "port": 34607,
            "source": "20.175.64.76",
            "mask": 24,
            "note": "test",
            "status": null,
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/firewall-rules

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

create

requires authentication

Create a new firewall rule.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"voluptas\",
    \"type\": \"deny\",
    \"protocol\": \"udp\",
    \"port\": \"qui\",
    \"source\": \"amet\",
    \"mask\": \"0\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'voluptas',
            'type' => 'deny',
            'protocol' => 'udp',
            'port' => 'qui',
            'source' => 'amet',
            'mask' => '0',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "voluptas",
    "type": "deny",
    "protocol": "udp",
    "port": "qui",
    "source": "amet",
    "mask": "0"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "name": "molestiae",
    "server_id": null,
    "type": "allow",
    "protocol": "tcp",
    "port": 26783,
    "source": "190.202.255.27",
    "mask": 24,
    "note": "test",
    "status": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/firewall-rules

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

Body Parameters

name string

Example: voluptas

type string

Example: deny

Must be one of:

allow
deny

protocol string

Example: udp

Must be one of:

tcp
udp

port string

Example: qui

source string optional

Example: amet

mask string

Mask for source IP. Example: 0

edit

requires authentication

Update an existing firewall rule.

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules/85" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"et\",
    \"type\": \"allow\",
    \"protocol\": \"tcp\",
    \"port\": \"rerum\",
    \"source\": \"sed\",
    \"mask\": \"0\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules/85';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'et',
            'type' => 'allow',
            'protocol' => 'tcp',
            'port' => 'rerum',
            'source' => 'sed',
            'mask' => '0',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules/85"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "et",
    "type": "allow",
    "protocol": "tcp",
    "port": "rerum",
    "source": "sed",
    "mask": "0"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "name": "labore",
    "server_id": null,
    "type": "allow",
    "protocol": "tcp",
    "port": 29044,
    "source": "113.132.217.224",
    "mask": 24,
    "note": "test",
    "status": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

firewallRule_id integer

The ID of the firewallRule. Example: 85

Body Parameters

name string

Example: et

type string

Example: allow

Must be one of:

allow
deny

protocol string

Example: tcp

Must be one of:

tcp
udp

port string

Example: rerum

source string optional

Example: sed

mask string

Mask for source IP. Example: 0

show

requires authentication

Get a firewall rule by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/firewall-rules/85" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules/85';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules/85"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "name": "ipsa",
    "server_id": null,
    "type": "allow",
    "protocol": "tcp",
    "port": 50679,
    "source": "42.114.67.31",
    "mask": 24,
    "note": "test",
    "status": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

firewallRule_id integer

The ID of the firewallRule. Example: 85

delete

requires authentication

Delete firewall rule.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules/85" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules/85';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/firewall-rules/85"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

firewallRule_id integer

The ID of the firewallRule. Example: 85

general

health-check

Example request:

curl --request GET \
    --get "https://your-vito-url/api/health" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/health';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/health"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):

Show headers

cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 58
access-control-allow-origin: *


{
    "success": true,
    "version": "2.4.0"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

projects

list

requires authentication

Get all projects.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": 3,
            "name": "Kattie Haley",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        },
        {
            "id": 4,
            "name": "Kailyn Kiehn",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

create

requires authentication

Create a new project.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"excepturi\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'excepturi',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "excepturi"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 3,
    "name": "Dayne White",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

Body Parameters

name string

The name of the project. Example: excepturi

show

requires authentication

Get a project by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": 3,
    "name": "Cheyenne Ankunding III",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

id integer

The ID of the project. Example: 1

update

requires authentication

Update project.

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"mollitia\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'mollitia',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "mollitia"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 3,
    "name": "Susanna Stark",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

id integer

The ID of the project. Example: 1

Body Parameters

name string

The name of the project. Example: mollitia

delete

requires authentication

Delete project.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

redirects

index

requires authentication

Get all redirects.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/11/redirects';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "site_id": null,
            "mode": 301,
            "from": "error",
            "to": "https://www.pfannerstill.com/facere-est-totam-laudantium-in-illo-sequi",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "site_id": null,
            "mode": 301,
            "from": "repellat",
            "to": "http://gislason.biz/sed-corrupti-et-id-earum-qui-consequatur-quis-voluptas.html",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 11

create

requires authentication

Create a new redirect.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"from\": \"vel\",
    \"to\": \"ea\",
    \"mode\": 307
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/11/redirects';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'from' => 'vel',
            'to' => 'ea',
            'mode' => 307,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "from": "vel",
    "to": "ea",
    "mode": 307
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 11

Body Parameters

from string

Example: vel

to string

Example: ea

mode string

Example: 307

Must be one of:

301
302
307
308

delete

requires authentication

Delete a redirect.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects/9" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/11/redirects/9';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects/9"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects/{redirect_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 11

redirect_id integer

The ID of the redirect. Example: 9

server-providers

list

requires authentication

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/server-providers" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/server-providers';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/server-providers"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": 3,
            "project_id": null,
            "global": true,
            "name": "id",
            "provider": "custom",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        },
        {
            "id": 4,
            "project_id": null,
            "global": true,
            "name": "culpa",
            "provider": "linode",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/server-providers

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

create

requires authentication

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/server-providers" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"provider\": \"mollitia\",
    \"name\": \"adipisci\",
    \"token\": \"animi\",
    \"key\": \"provident\",
    \"secret\": \"deserunt\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/server-providers';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'provider' => 'mollitia',
            'name' => 'adipisci',
            'token' => 'animi',
            'key' => 'provident',
            'secret' => 'deserunt',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/server-providers"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "provider": "mollitia",
    "name": "adipisci",
    "token": "animi",
    "key": "provident",
    "secret": "deserunt"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 3,
    "project_id": null,
    "global": true,
    "name": "et",
    "provider": "vultr",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/server-providers

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

Body Parameters

provider string

The provider (aws, linode, hetzner, digitalocean, vultr, ...) Example: mollitia

name string

The name of the server provider. Example: adipisci

token string

The token if provider requires api token Example: animi

key string

The key if provider requires key Example: provident

secret string

The secret if provider requires key Example: deserunt

show

requires authentication

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/server-providers/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/server-providers/1';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/server-providers/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": 3,
    "project_id": null,
    "global": true,
    "name": "ab",
    "provider": "digitalocean",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/server-providers/{serverProvider_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

serverProvider_id integer

The ID of the serverProvider. Example: 1

update

requires authentication

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1/server-providers/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"eveniet\",
    \"global\": false
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/server-providers/1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'eveniet',
            'global' => false,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/server-providers/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "eveniet",
    "global": false
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 3,
    "project_id": null,
    "global": true,
    "name": "expedita",
    "provider": "aws",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{project_id}/server-providers/{serverProvider_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

serverProvider_id integer

The ID of the serverProvider. Example: 1

Body Parameters

name string

The name of the server provider. Example: eveniet

global string

Accessible in all projects Example: false

Must be one of:

delete

requires authentication

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/server-providers/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/server-providers/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/server-providers/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/server-providers/{serverProvider_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

serverProvider_id integer

The ID of the serverProvider. Example: 1

servers

list

requires authentication

Get all servers in a project.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "project_id": null,
            "user_id": null,
            "provider_id": null,
            "name": "Consuelo Connelly",
            "ssh_user": "vito",
            "ip": "80.154.83.232",
            "local_ip": "45.31.117.65",
            "port": 22,
            "os": "ubuntu_22",
            "type": "regular",
            "type_data": null,
            "provider": "custom",
            "provider_data": null,
            "public_key": "test",
            "status": "ready",
            "auto_update": null,
            "available_updates": 0,
            "security_updates": null,
            "progress": 100,
            "progress_step": null,
            "updates": null,
            "last_update_check": null,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "project_id": null,
            "user_id": null,
            "provider_id": null,
            "name": "Rodolfo Fadel",
            "ssh_user": "vito",
            "ip": "103.227.79.93",
            "local_ip": "33.49.217.56",
            "port": 22,
            "os": "ubuntu_22",
            "type": "regular",
            "type_data": null,
            "provider": "custom",
            "provider_data": null,
            "public_key": "test",
            "status": "ready",
            "auto_update": null,
            "available_updates": 0,
            "security_updates": null,
            "progress": 100,
            "progress_step": null,
            "updates": null,
            "last_update_check": null,
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

create

requires authentication

Create a new server.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"provider\": \"incidunt\",
    \"server_provider\": \"hetzner\",
    \"region\": \"ut\",
    \"plan\": \"ullam\",
    \"ip\": \"architecto\",
    \"port\": \"praesentium\",
    \"name\": \"facere\",
    \"os\": \"illo\",
    \"webserver\": \"none\",
    \"database\": \"none\",
    \"php\": \"8.1\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'provider' => 'incidunt',
            'server_provider' => 'hetzner',
            'region' => 'ut',
            'plan' => 'ullam',
            'ip' => 'architecto',
            'port' => 'praesentium',
            'name' => 'facere',
            'os' => 'illo',
            'webserver' => 'none',
            'database' => 'none',
            'php' => '8.1',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "provider": "incidunt",
    "server_provider": "hetzner",
    "region": "ut",
    "plan": "ullam",
    "ip": "architecto",
    "port": "praesentium",
    "name": "facere",
    "os": "illo",
    "webserver": "none",
    "database": "none",
    "php": "8.1"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "project_id": null,
    "user_id": null,
    "provider_id": null,
    "name": "Herbert VonRueden",
    "ssh_user": "vito",
    "ip": "91.154.105.143",
    "local_ip": "62.75.177.7",
    "port": 22,
    "os": "ubuntu_22",
    "type": "regular",
    "type_data": null,
    "provider": "custom",
    "provider_data": null,
    "public_key": "test",
    "status": "ready",
    "auto_update": null,
    "available_updates": 0,
    "security_updates": null,
    "progress": 100,
    "progress_step": null,
    "updates": null,
    "last_update_check": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

Body Parameters

provider string

The server provider type Example: incidunt

server_provider string

If the provider is not custom, the ID of the server provider profile Example: hetzner

Must be one of:

custom
hetzner
digitalocean
linode
vultr

region string

Provider region if the provider is not custom Example: ut

plan string

Provider plan if the provider is not custom Example: ullam

ip string

SSH IP address if the provider is custom Example: architecto

port string

SSH Port if the provider is custom Example: praesentium

name string

The name of the server. Example: facere

os string

The os of the server Example: illo

webserver string

Web server Example: none

Must be one of:

none
nginx

database string

Database Example: none

Must be one of:

none
mysql57
mysql80
mariadb103
mariadb104
mariadb103
postgresql12
postgresql13
postgresql14
postgresql15
postgresql16

php string

PHP version Example: 8.1

Must be one of:

7.0
7.1
7.2
7.3
7.4
8.0
8.1
8.2
8.3

show

requires authentication

Get a server by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "project_id": null,
    "user_id": null,
    "provider_id": null,
    "name": "Connie Simonis",
    "ssh_user": "vito",
    "ip": "202.119.26.253",
    "local_ip": "112.75.79.203",
    "port": 22,
    "os": "ubuntu_22",
    "type": "regular",
    "type_data": null,
    "provider": "custom",
    "provider_data": null,
    "public_key": "test",
    "status": "ready",
    "auto_update": null,
    "available_updates": 0,
    "security_updates": null,
    "progress": 100,
    "progress_step": null,
    "updates": null,
    "last_update_check": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

id integer

The ID of the server. Example: 29

reboot

requires authentication

Reboot a server.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/reboot" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/reboot';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/reboot"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/reboot

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

upgrade

requires authentication

Upgrade server.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/upgrade" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/upgrade';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/upgrade"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/upgrade

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

delete

requires authentication

Delete server.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

services

list

requires authentication

Get all services.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/services" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "server_id": null,
            "type": null,
            "type_data": null,
            "name": null,
            "version": null,
            "unit": null,
            "status": null,
            "is_default": null,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "type": null,
            "type_data": null,
            "name": null,
            "version": null,
            "unit": null,
            "status": null,
            "is_default": null,
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/services

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

show

requires authentication

Get a service by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/services/169" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "type": null,
    "type_data": null,
    "name": null,
    "version": null,
    "unit": null,
    "status": null,
    "is_default": null,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/services/{id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

id integer

The ID of the service. Example: 169

start

requires authentication

Start service.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/services/169/start" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169/start';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169/start"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/services/{service_id}/start

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

service_id integer

The ID of the service. Example: 169

stop

requires authentication

Stop service.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/services/169/stop" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169/stop';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169/stop"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/services/{service_id}/stop

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

service_id integer

The ID of the service. Example: 169

restart

requires authentication

Restart service.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/services/169/restart" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169/restart';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169/restart"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/services/{service_id}/restart

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

service_id integer

The ID of the service. Example: 169

enable

requires authentication

Enable service.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/services/169/enable" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169/enable';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169/enable"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/services/{service_id}/enable

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

service_id integer

The ID of the service. Example: 169

disable

requires authentication

Disable service.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/services/169/disable" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169/disable';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169/disable"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/services/{service_id}/disable

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

service_id integer

The ID of the service. Example: 169

delete

requires authentication

Delete service.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/services/169" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/services/169';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/services/169"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/services/{service_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

service_id integer

The ID of the service. Example: 169

sites

list

requires authentication

Get all sites.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/sites" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "server_id": null,
            "source_control_id": null,
            "type": "laravel",
            "type_data": null,
            "domain": "test.com",
            "aliases": null,
            "web_directory": "/",
            "path": "/home",
            "php_version": "8.2",
            "repository": null,
            "branch": "main",
            "status": "ready",
            "port": null,
            "user": "vito",
            "progress": 100,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "source_control_id": null,
            "type": "laravel",
            "type_data": null,
            "domain": "test.com",
            "aliases": null,
            "web_directory": "/",
            "path": "/home",
            "php_version": "8.2",
            "repository": null,
            "branch": "main",
            "status": "ready",
            "port": null,
            "user": "vito",
            "progress": 100,
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/sites

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

create

requires authentication

Create a new site.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/sites" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"type\": \"phpmyadmin\",
    \"domain\": \"tenetur\",
    \"aliases\": [
        \"aut\"
    ],
    \"php_version\": \"7.4\",
    \"web_directory\": \"public\",
    \"source_control\": \"quasi\",
    \"repository\": \"organization\\/repository\",
    \"branch\": \"main\",
    \"composer\": true,
    \"version\": \"5.2.1\",
    \"user\": \"deleniti\",
    \"method\": \"round-robin\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'type' => 'phpmyadmin',
            'domain' => 'tenetur',
            'aliases' => [
                'aut',
            ],
            'php_version' => '7.4',
            'web_directory' => 'public',
            'source_control' => 'quasi',
            'repository' => 'organization/repository',
            'branch' => 'main',
            'composer' => true,
            'version' => '5.2.1',
            'user' => 'deleniti',
            'method' => 'round-robin',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "type": "phpmyadmin",
    "domain": "tenetur",
    "aliases": [
        "aut"
    ],
    "php_version": "7.4",
    "web_directory": "public",
    "source_control": "quasi",
    "repository": "organization\/repository",
    "branch": "main",
    "composer": true,
    "version": "5.2.1",
    "user": "deleniti",
    "method": "round-robin"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "source_control_id": null,
    "type": "laravel",
    "type_data": null,
    "domain": "test.com",
    "aliases": null,
    "web_directory": "/",
    "path": "/home",
    "php_version": "8.2",
    "repository": null,
    "branch": "main",
    "status": "ready",
    "port": null,
    "user": "vito",
    "progress": 100,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/sites

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

Body Parameters

type string

Example: phpmyadmin

Must be one of:

php
php-blank
phpmyadmin
laravel
wordpress
load-balancer

domain string

Example: tenetur

aliases string[]

php_version string

One of the installed PHP Versions Example: 7.4

web_directory string

Required for PHP and Laravel sites Example: public

source_control string

Source control ID, Required for Sites which support source control Example: quasi

repository string

Repository, Required for Sites which support source control Example: organization/repository

branch string

Branch, Required for Sites which support source control Example: main

composer boolean true false

Run composer if site supports composer Example: true

version string

Version, if the site type requires a version like PHPMyAdmin Example: 5.2.1

user string

user, to isolate the website under a new user Example: deleniti

method string

Load balancer method, Required if the site type is Load balancer Example: round-robin

Must be one of:

round-robin
least-connections
ip-hash

show

requires authentication

Get a site by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/sites/12" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/12';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/12"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "server_id": null,
    "source_control_id": null,
    "type": "laravel",
    "type_data": null,
    "domain": "test.com",
    "aliases": null,
    "web_directory": "/",
    "path": "/home",
    "php_version": "8.2",
    "repository": null,
    "branch": "main",
    "status": "ready",
    "port": null,
    "user": "vito",
    "progress": 100,
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/sites/{id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

id integer

The ID of the site. Example: 12

delete

requires authentication

Delete site.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/sites/9" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/9';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/9"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/sites/{site_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 9

load-balancer

requires authentication

Update load balancer.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/sites/19/load-balancer" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"method\": \"ip-hash\",
    \"servers\": [
        \"dolores\"
    ]
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/19/load-balancer';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'method' => 'ip-hash',
            'servers' => [
                'dolores',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/19/load-balancer"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "method": "ip-hash",
    "servers": [
        "dolores"
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/sites/{site_id}/load-balancer

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 19

Body Parameters

method string

Load balancer method, Required if the site type is Load balancer Example: ip-hash

Must be one of:

round-robin
least-connections
ip-hash

servers string[]

Array of servers including server, port, weight, backup. (server is the local IP of the server)

aliases

requires authentication

Update aliases.

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1/servers/29/sites/16/aliases" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"aliases\": [
        \"aut\"
    ]
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/16/aliases';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'aliases' => [
                'aut',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/16/aliases"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "aliases": [
        "aut"
    ]
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{project_id}/servers/{server_id}/sites/{site_id}/aliases

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 16

Body Parameters

aliases string[]

Array of aliases

deployment-script

requires authentication

Update site deployment script

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1/servers/29/sites/3/deployment-script" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"script\": \"qui\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/3/deployment-script';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'script' => 'qui',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/3/deployment-script"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "script": "qui"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{project_id}/servers/{server_id}/sites/{site_id}/deployment-script

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 3

Body Parameters

script string

Content of the deployment script Example: qui

deployment-script

requires authentication

Get site deployment script content

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/sites/16/deployment-script" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/16/deployment-script';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/sites/16/deployment-script"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/sites/{site_id}/deployment-script

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

site_id integer

The ID of the site. Example: 16

source-controls

list

requires authentication

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/source-controls" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/source-controls';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/source-controls"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": 5,
            "project_id": null,
            "global": true,
            "name": "Emil Leannon",
            "provider": "github",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        },
        {
            "id": 6,
            "project_id": null,
            "global": true,
            "name": "Eleazar Pacocha Sr.",
            "provider": "github",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/source-controls

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

create

requires authentication

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/source-controls" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"provider\": \"github\",
    \"name\": \"aliquam\",
    \"token\": \"voluptatem\",
    \"url\": \"https:\\/\\/brown.org\\/placeat-optio-illum-eius-ipsa.html\",
    \"username\": \"a\",
    \"password\": \"_\\/_,9\'\\/6z;9\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/source-controls';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'provider' => 'github',
            'name' => 'aliquam',
            'token' => 'voluptatem',
            'url' => 'https://brown.org/placeat-optio-illum-eius-ipsa.html',
            'username' => 'a',
            'password' => '_/_,9\'/6z;9',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/source-controls"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "provider": "github",
    "name": "aliquam",
    "token": "voluptatem",
    "url": "https:\/\/brown.org\/placeat-optio-illum-eius-ipsa.html",
    "username": "a",
    "password": "_\/_,9'\/6z;9"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "Ahmad Kulas",
    "provider": "github",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/source-controls

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

Body Parameters

provider string

The provider Example: github

Must be one of:

gitlab
github
bitbucket

name string

The name of the storage provider. Example: aliquam

token string

The token if provider requires api token Example: voluptatem

url string

The URL if the provider is Gitlab and it is self-hosted Example: https://brown.org/placeat-optio-illum-eius-ipsa.html

username string

The username if the provider is Bitbucket Example: a

password string

The password if the provider is Bitbucket Example: _/_,9'/6z;9

show

requires authentication

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/source-controls/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/source-controls/1';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/source-controls/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "Mr. Marquis Kunde IV",
    "provider": "github",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/source-controls/{sourceControl_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

sourceControl_id integer

The ID of the sourceControl. Example: 1

update

requires authentication

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1/source-controls/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"laudantium\",
    \"token\": \"nulla\",
    \"url\": \"http:\\/\\/wiza.com\\/\",
    \"username\": \"numquam\",
    \"password\": \"MlD,$m:8^A\",
    \"global\": false
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/source-controls/1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'laudantium',
            'token' => 'nulla',
            'url' => 'http://wiza.com/',
            'username' => 'numquam',
            'password' => 'MlD,$m:8^A',
            'global' => false,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/source-controls/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "laudantium",
    "token": "nulla",
    "url": "http:\/\/wiza.com\/",
    "username": "numquam",
    "password": "MlD,$m:8^A",
    "global": false
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "Mrs. Arvilla Mitchell",
    "provider": "github",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{project_id}/source-controls/{sourceControl_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

sourceControl_id integer

The ID of the sourceControl. Example: 1

Body Parameters

name string

The name of the storage provider. Example: laudantium

token string

The token if provider requires api token Example: nulla

url string

The URL if the provider is Gitlab and it is self-hosted Example: http://wiza.com/

username string

The username if the provider is Bitbucket Example: numquam

password string

The password if the provider is Bitbucket Example: MlD,$m:8^A

global string

Accessible in all projects Example: false

Must be one of:

delete

requires authentication

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/source-controls/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/source-controls/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/source-controls/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/source-controls/{sourceControl_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

sourceControl_id integer

The ID of the sourceControl. Example: 1

ssh-keys

list

requires authentication

Get all ssh keys.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/ssh-keys" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/ssh-keys';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/ssh-keys"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": null,
            "user": null,
            "name": "Dr. Pansy Kunde DVM",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "user": null,
            "name": "Ms. Maximillia DuBuque Sr.",
            "created_at": null,
            "updated_at": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/servers/{server_id}/ssh-keys

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

create

requires authentication

Deploy ssh key to server.

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/ssh-keys" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"key_id\": \"debitis\",
    \"name\": \"illum\",
    \"public_key\": \"dignissimos\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/ssh-keys';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'key_id' => 'debitis',
            'name' => 'illum',
            'public_key' => 'dignissimos',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/ssh-keys"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "key_id": "debitis",
    "name": "illum",
    "public_key": "dignissimos"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": null,
    "user": null,
    "name": "Uriah Harvey",
    "created_at": null,
    "updated_at": null
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/servers/{server_id}/ssh-keys

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

Body Parameters

key_id string

The ID of the key. Example: debitis

name string

Key name, required if key_id is not provided. Example: illum

public_key string

Public Key, required if key_id is not provided. Example: dignissimos

delete

requires authentication

Delete ssh key from server.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/ssh-keys/1" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/servers/29/ssh-keys/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/servers/29/ssh-keys/1"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/servers/{server_id}/ssh-keys/{sshKey_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

server_id integer

The ID of the server. Example: 29

sshKey_id integer

The ID of the sshKey. Example: 1

storage-providers

list

requires authentication

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/storage-providers" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/storage-providers';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/storage-providers"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "data": [
        {
            "id": 5,
            "project_id": null,
            "global": true,
            "name": "autem",
            "provider": "s3",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        },
        {
            "id": 6,
            "project_id": null,
            "global": true,
            "name": "nihil",
            "provider": "ftp",
            "created_at": "2025-03-31T15:27:17.000000Z",
            "updated_at": "2025-03-31T15:27:17.000000Z"
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/storage-providers

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

create

requires authentication

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/storage-providers" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"provider\": \"est\",
    \"name\": \"voluptatem\",
    \"token\": \"delectus\",
    \"key\": \"natus\",
    \"secret\": \"saepe\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/storage-providers';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'provider' => 'est',
            'name' => 'voluptatem',
            'token' => 'delectus',
            'key' => 'natus',
            'secret' => 'saepe',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/storage-providers"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "provider": "est",
    "name": "voluptatem",
    "token": "delectus",
    "key": "natus",
    "secret": "saepe"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "omnis",
    "provider": "local",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

POST api/projects/{project_id}/storage-providers

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

Body Parameters

provider string

The provider (aws, linode, hetzner, digitalocean, vultr, ...) Example: est

name string

The name of the storage provider. Example: voluptatem

token string

The token if provider requires api token Example: delectus

key string

The key if provider requires key Example: natus

secret string

The secret if provider requires key Example: saepe

show

requires authentication

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/storage-providers/3" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/storage-providers/3';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/storage-providers/3"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "molestiae",
    "provider": "dropbox",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

GET api/projects/{project_id}/storage-providers/{storageProvider_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

storageProvider_id integer

The ID of the storageProvider. Example: 3

update

requires authentication

Example request:

curl --request PUT \
    "https://your-vito-url/api/projects/1/storage-providers/3" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"exercitationem\",
    \"global\": true
}"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/storage-providers/3';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'exercitationem',
            'global' => true,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/storage-providers/3"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "exercitationem",
    "global": true
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "dolorum",
    "provider": "s3",
    "created_at": "2025-03-31T15:27:17.000000Z",
    "updated_at": "2025-03-31T15:27:17.000000Z"
}

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

PUT api/projects/{project_id}/storage-providers/{storageProvider_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

storageProvider_id integer

The ID of the storageProvider. Example: 3

Body Parameters

name string

The name of the storage provider. Example: exercitationem

global string

Accessible in all projects Example: true

Must be one of:

delete

requires authentication

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/storage-providers/3" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

$client = new \GuzzleHttp\Client();
$url = 'https://your-vito-url/api/projects/1/storage-providers/3';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR-API-KEY',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://your-vito-url/api/projects/1/storage-providers/3"
);

const headers = {
    "Authorization": "Bearer YOUR-API-KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (204):

Empty response

Received response:

Request failed with error:



Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.

Request

DELETE api/projects/{project_id}/storage-providers/{storageProvider_id}

Headers

Authorization

Example: Bearer YOUR-API-KEY

Content-Type

Example: application/json

Accept

Example: application/json

URL Parameters

project_id integer

The ID of the project. Example: 1

storageProvider_id integer

The ID of the storageProvider. Example: 3

Introduction

Authenticating requests

cron-jobs

list

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

create

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Body Parameters

show

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

delete

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

database-users

list

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

create

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Body Parameters

show

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

link

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Body Parameters

delete

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

databases

list

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

create

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Body Parameters

show

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

delete

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

firewall-rules

list

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

create

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Body Parameters

edit

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Body Parameters

show

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Headers

URL Parameters

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request

Request