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\": \"quia\",
    \"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' => 'quia',
            '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": "quia",
    "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: quia

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/6" \
    --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/6';
$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/6"
);

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: 6

delete

requires authentication

Delete cron job.

Example request:

curl --request DELETE \
    "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->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/13"
);

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: 13

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": "letha64",
            "databases": [],
            "host": "%",
            "status": null,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "username": "hagenes.lurline",
            "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\": \"qui\",
    \"password\": \"xYv*3,#HQ=5<w!\",
    \"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' => 'qui',
            'password' => 'xYv*3,#HQ=5<w!',
            '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": "qui",
    "password": "xYv*3,#HQ=5<w!",
    "host": "%"
};

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

Example response (200):


{
    "id": null,
    "server_id": null,
    "username": "marcelle95",
    "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: qui

password string

Example: xYv*3,#HQ=5<w!

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/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/database-users/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/servers/29/database-users/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": null,
    "server_id": null,
    "username": "brandi53",
    "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: 1

link

requires authentication

Link to databases

Example request:

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

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

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

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

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

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

Example response (200):


{
    "id": null,
    "server_id": null,
    "username": "kschmidt",
    "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: 4

Body Parameters

databases string

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

delete

requires authentication

Delete database user.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/database-users/20" \
    --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/20';
$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/20"
);

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: 20

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": "leffler.esther",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "server_id": null,
            "name": "rhoda.rutherford",
            "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\": \"quisquam\",
    \"charset\": \"omnis\",
    \"collation\": \"at\"
}"

$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' => 'quisquam',
            'charset' => 'omnis',
            'collation' => 'at',
        ],
    ]
);
$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": "quisquam",
    "charset": "omnis",
    "collation": "at"
};

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

Example response (200):


{
    "id": null,
    "server_id": null,
    "name": "csawayn",
    "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: quisquam

charset string

Example: omnis

collation string

Example: at

show

requires authentication

Get a database by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/databases/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/databases/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/databases/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,
    "name": "sandrine43",
    "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: 8

delete

requires authentication

Delete database.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/databases/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/databases/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/databases/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}/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: 8

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": "ut",
            "server_id": null,
            "type": "allow",
            "protocol": "tcp",
            "port": 35499,
            "source": "177.130.54.250",
            "mask": 24,
            "note": "test",
            "status": null,
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "name": "totam",
            "server_id": null,
            "type": "allow",
            "protocol": "tcp",
            "port": 29448,
            "source": "181.194.26.13",
            "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\": \"sapiente\",
    \"type\": \"allow\",
    \"protocol\": \"tcp\",
    \"port\": \"et\",
    \"source\": \"doloribus\",
    \"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' => 'sapiente',
            'type' => 'allow',
            'protocol' => 'tcp',
            'port' => 'et',
            'source' => 'doloribus',
            '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": "sapiente",
    "type": "allow",
    "protocol": "tcp",
    "port": "et",
    "source": "doloribus",
    "mask": "0"
};

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

Example response (200):


{
    "id": null,
    "name": "omnis",
    "server_id": null,
    "type": "allow",
    "protocol": "tcp",
    "port": 54634,
    "source": "246.242.9.65",
    "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: sapiente

type string

Example: allow

Must be one of:

allow
deny

protocol string

Example: tcp

Must be one of:

tcp
udp

port string

Example: et

source string optional

Example: doloribus

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\": \"aut\",
    \"source\": \"et\",
    \"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' => 'aut',
            'source' => 'et',
            '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": "aut",
    "source": "et",
    "mask": "0"
};

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

Example response (200):


{
    "id": null,
    "name": "consequatur",
    "server_id": null,
    "type": "allow",
    "protocol": "tcp",
    "port": 879,
    "source": "206.106.27.116",
    "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: aut

source string optional

Example: et

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": "dolores",
    "server_id": null,
    "type": "allow",
    "protocol": "tcp",
    "port": 4691,
    "source": "147.108.28.144",
    "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: 59
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": "Mr. Drake Nader",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.000000Z"
        },
        {
            "id": 4,
            "name": "Wilhelmine Jacobson",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.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\": \"dignissimos\"
}"

$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' => 'dignissimos',
        ],
    ]
);
$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": "dignissimos"
};

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

Example response (200):


{
    "id": 3,
    "name": "Pattie Cole",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: dignissimos

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": "Mr. Elias Bauch",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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\": \"sunt\"
}"

$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' => 'sunt',
        ],
    ]
);
$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": "sunt"
};

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

Example response (200):


{
    "id": 3,
    "name": "Elfrieda Jakubowski",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: sunt

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/44/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/44/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/44/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": 307,
            "from": "ipsum",
            "to": "http://fritsch.biz/",
            "status": "ready",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "site_id": null,
            "mode": 302,
            "from": "culpa",
            "to": "http://www.huels.net/aut-ut-ut-porro-non-rerum-voluptatum.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: 44

create

requires authentication

Create a new redirect.

Example request:

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

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

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

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

let body = {
    "from": "odit",
    "to": "incidunt",
    "mode": 301
};

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: 44

Body Parameters

from string

Example: odit

to string

Example: incidunt

mode string

Example: 301

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/44/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/44/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/44/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: 44

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": "aut",
            "provider": "hetzner",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.000000Z"
        },
        {
            "id": 4,
            "project_id": null,
            "global": true,
            "name": "qui",
            "provider": "aws",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.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\": \"corrupti\",
    \"name\": \"est\",
    \"token\": \"rerum\",
    \"key\": \"ut\",
    \"secret\": \"sed\"
}"

$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' => 'corrupti',
            'name' => 'est',
            'token' => 'rerum',
            'key' => 'ut',
            'secret' => 'sed',
        ],
    ]
);
$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": "corrupti",
    "name": "est",
    "token": "rerum",
    "key": "ut",
    "secret": "sed"
};

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

Example response (200):


{
    "id": 3,
    "project_id": null,
    "global": true,
    "name": "voluptas",
    "provider": "vultr",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: corrupti

name string

The name of the server provider. Example: est

token string

The token if provider requires api token Example: rerum

key string

The key if provider requires key Example: ut

secret string

The secret if provider requires key Example: sed

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": "et",
    "provider": "digitalocean",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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\": \"earum\",
    \"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' => 'earum',
            '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": "earum",
    "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": "architecto",
    "provider": "digitalocean",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: earum

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": "Miss Bonita Vandervort IV",
            "ssh_user": "vito",
            "ip": "120.222.195.212",
            "local_ip": "138.119.37.248",
            "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": "Dr. Shanie Batz IV",
            "ssh_user": "vito",
            "ip": "241.88.138.163",
            "local_ip": "138.226.232.93",
            "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\": \"fugiat\",
    \"server_provider\": \"digitalocean\",
    \"region\": \"itaque\",
    \"plan\": \"voluptatum\",
    \"ip\": \"ut\",
    \"port\": \"reiciendis\",
    \"name\": \"et\",
    \"os\": \"vel\",
    \"webserver\": \"nginx\",
    \"database\": \"mysql80\",
    \"php\": \"7.2\"
}"

$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' => 'fugiat',
            'server_provider' => 'digitalocean',
            'region' => 'itaque',
            'plan' => 'voluptatum',
            'ip' => 'ut',
            'port' => 'reiciendis',
            'name' => 'et',
            'os' => 'vel',
            'webserver' => 'nginx',
            'database' => 'mysql80',
            'php' => '7.2',
        ],
    ]
);
$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": "fugiat",
    "server_provider": "digitalocean",
    "region": "itaque",
    "plan": "voluptatum",
    "ip": "ut",
    "port": "reiciendis",
    "name": "et",
    "os": "vel",
    "webserver": "nginx",
    "database": "mysql80",
    "php": "7.2"
};

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": "Jeromy Mann",
    "ssh_user": "vito",
    "ip": "128.70.209.89",
    "local_ip": "150.217.250.187",
    "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: fugiat

server_provider string

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

Must be one of:

custom
hetzner
digitalocean
linode
vultr

region string

Provider region if the provider is not custom Example: itaque

plan string

Provider plan if the provider is not custom Example: voluptatum

ip string

SSH IP address if the provider is custom Example: ut

port string

SSH Port if the provider is custom Example: reiciendis

name string

The name of the server. Example: et

os string

The os of the server Example: vel

webserver string

Web server Example: nginx

Must be one of:

none
nginx

database string

Database Example: mysql80

Must be one of:

none
mysql57
mysql80
mariadb103
mariadb104
mariadb103
postgresql12
postgresql13
postgresql14
postgresql15
postgresql16

php string

PHP version Example: 7.2

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": "Miss Maya Schaden I",
    "ssh_user": "vito",
    "ip": "44.57.83.39",
    "local_ip": "46.22.92.58",
    "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\": \"php-blank\",
    \"domain\": \"impedit\",
    \"aliases\": [
        \"cum\"
    ],
    \"php_version\": \"7.4\",
    \"web_directory\": \"public\",
    \"source_control\": \"non\",
    \"repository\": \"organization\\/repository\",
    \"branch\": \"main\",
    \"composer\": true,
    \"version\": \"5.2.1\",
    \"user\": \"voluptate\",
    \"method\": \"ip-hash\"
}"

$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' => 'php-blank',
            'domain' => 'impedit',
            'aliases' => [
                'cum',
            ],
            'php_version' => '7.4',
            'web_directory' => 'public',
            'source_control' => 'non',
            'repository' => 'organization/repository',
            'branch' => 'main',
            'composer' => true,
            'version' => '5.2.1',
            'user' => 'voluptate',
            'method' => 'ip-hash',
        ],
    ]
);
$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": "php-blank",
    "domain": "impedit",
    "aliases": [
        "cum"
    ],
    "php_version": "7.4",
    "web_directory": "public",
    "source_control": "non",
    "repository": "organization\/repository",
    "branch": "main",
    "composer": true,
    "version": "5.2.1",
    "user": "voluptate",
    "method": "ip-hash"
};

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: php-blank

Must be one of:

php
php-blank
phpmyadmin
laravel
wordpress
load-balancer

domain string

Example: impedit

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: non

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: voluptate

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

show

requires authentication

Get a site by ID.

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/sites/44" \
    --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/44';
$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/44"
);

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: 44

delete

requires authentication

Delete site.

Example request:

curl --request DELETE \
    "https://your-vito-url/api/projects/1/servers/29/sites/44" \
    --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/44';
$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/44"
);

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: 44

load-balancer

requires authentication

Update load balancer.

Example request:

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

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

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

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

let body = {
    "method": "round-robin",
    "servers": [
        "omnis"
    ]
};

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: 44

Body Parameters

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

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/44/aliases" \
    --header "Authorization: Bearer YOUR-API-KEY" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"aliases\": [
        \"doloremque\"
    ]
}"

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

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

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

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

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: 44

Body Parameters

aliases string[]

Array of aliases

deploy

requires authentication

Run site deployment script

Example request:

curl --request POST \
    "https://your-vito-url/api/projects/1/servers/29/sites/44/deploy" \
    --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/44/deploy';
$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/sites/44/deploy"
);

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 (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}/deploy

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: 44

deployment-script

requires authentication

Update site deployment script

Example request:

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

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

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

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

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

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: 44

Body Parameters

script string

Content of the deployment script Example: voluptatem

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/44/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/44/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/44/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: 44

env

requires authentication

Get site .env file content

Example request:

curl --request GET \
    --get "https://your-vito-url/api/projects/1/servers/29/sites/44/env" \
    --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/44/env';
$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/44/env"
);

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": {
        "env": "APP_NAME=Laravel\\nAPP_ENV=production"
    }
}

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}/env

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: 44

env

requires authentication

Update site .env file

Example request:

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

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

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

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

let body = {
    "env": "quam"
};

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}/env

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: 44

Body Parameters

env string

Content of the .env file Example: quam

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": "Zella Robel",
            "provider": "github",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.000000Z"
        },
        {
            "id": 6,
            "project_id": null,
            "global": true,
            "name": "Jairo Williamson",
            "provider": "github",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.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\": \"gitlab\",
    \"name\": \"molestias\",
    \"token\": \"in\",
    \"url\": \"https:\\/\\/www.white.com\\/aperiam-dolor-nemo-qui-rerum-quod-quas\",
    \"username\": \"consectetur\",
    \"password\": \"y*P4_]ZdjE_:\"
}"

$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' => 'gitlab',
            'name' => 'molestias',
            'token' => 'in',
            'url' => 'https://www.white.com/aperiam-dolor-nemo-qui-rerum-quod-quas',
            'username' => 'consectetur',
            'password' => 'y*P4_]ZdjE_:',
        ],
    ]
);
$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": "gitlab",
    "name": "molestias",
    "token": "in",
    "url": "https:\/\/www.white.com\/aperiam-dolor-nemo-qui-rerum-quod-quas",
    "username": "consectetur",
    "password": "y*P4_]ZdjE_:"
};

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

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "Miss Claudine Goyette",
    "provider": "github",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: gitlab

Must be one of:

gitlab
github
bitbucket

name string

The name of the storage provider. Example: molestias

token string

The token if provider requires api token Example: in

url string

The URL if the provider is Gitlab and it is self-hosted Example: https://www.white.com/aperiam-dolor-nemo-qui-rerum-quod-quas

username string

The username if the provider is Bitbucket Example: consectetur

password string

The password if the provider is Bitbucket Example: y*P4_]ZdjE_:

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": "Mona Stark",
    "provider": "github",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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\": \"non\",
    \"token\": \"sunt\",
    \"url\": \"https:\\/\\/www.frami.org\\/ex-at-minus-rerum-quo-minus-ea\",
    \"username\": \"natus\",
    \"password\": \"A^\\\">*m{p]DI\",
    \"global\": true
}"

$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' => 'non',
            'token' => 'sunt',
            'url' => 'https://www.frami.org/ex-at-minus-rerum-quo-minus-ea',
            'username' => 'natus',
            'password' => 'A^">*m{p]DI',
            'global' => true,
        ],
    ]
);
$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": "non",
    "token": "sunt",
    "url": "https:\/\/www.frami.org\/ex-at-minus-rerum-quo-minus-ea",
    "username": "natus",
    "password": "A^\">*m{p]DI",
    "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": "Neha Little",
    "provider": "github",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: non

token string

The token if provider requires api token Example: sunt

url string

The URL if the provider is Gitlab and it is self-hosted Example: https://www.frami.org/ex-at-minus-rerum-quo-minus-ea

username string

The username if the provider is Bitbucket Example: natus

password string *m{p]DI" data-component="body">

The password if the provider is Bitbucket Example: A^">*m{p]DI

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/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": "Santa Goyette",
            "created_at": null,
            "updated_at": null
        },
        {
            "id": null,
            "user": null,
            "name": "Cecil Cummings",
            "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\": \"explicabo\",
    \"name\": \"deleniti\",
    \"public_key\": \"sapiente\"
}"

$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' => 'explicabo',
            'name' => 'deleniti',
            'public_key' => 'sapiente',
        ],
    ]
);
$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": "explicabo",
    "name": "deleniti",
    "public_key": "sapiente"
};

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

Example response (200):


{
    "id": null,
    "user": null,
    "name": "Mr. Reagan Jacobson V",
    "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: explicabo

name string

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

public_key string

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

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": "veritatis",
            "provider": "ftp",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.000000Z"
        },
        {
            "id": 6,
            "project_id": null,
            "global": true,
            "name": "voluptas",
            "provider": "dropbox",
            "created_at": "2025-04-05T17:48:03.000000Z",
            "updated_at": "2025-04-05T17:48:03.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\": \"ab\",
    \"name\": \"quo\",
    \"token\": \"in\",
    \"key\": \"sunt\",
    \"secret\": \"molestias\"
}"

$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' => 'ab',
            'name' => 'quo',
            'token' => 'in',
            'key' => 'sunt',
            'secret' => 'molestias',
        ],
    ]
);
$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": "ab",
    "name": "quo",
    "token": "in",
    "key": "sunt",
    "secret": "molestias"
};

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

Example response (200):


{
    "id": 5,
    "project_id": null,
    "global": true,
    "name": "asperiores",
    "provider": "dropbox",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: ab

name string

The name of the storage provider. Example: quo

token string

The token if provider requires api token Example: in

key string

The key if provider requires key Example: sunt

secret string

The secret if provider requires key Example: molestias

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": "ipsum",
    "provider": "local",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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\": \"voluptas\",
    \"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' => 'voluptas',
            '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": "voluptas",
    "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": "minima",
    "provider": "ftp",
    "created_at": "2025-04-05T17:48:03.000000Z",
    "updated_at": "2025-04-05T17:48:03.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: voluptas

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