mirror of
https://github.com/vitodeploy/vito.git
synced 2025-04-19 09:51:37 +00:00
f483f7fdca
* feat(redirects): add redirects to sites * chore(style): fixed coding style issues * style: fix php-stan docblocks * style: pint cleanup * tests: fixed redirect test suite * feat: vhosts include additional configs * fix: use exact location matching * - add enums - use queues - use vhost rather than separate conf files - vhost formatter - cleanup * generate docs --------- Co-authored-by: Saeed Vaziry <mr.saeedvaziry@gmail.com>
14379 lines
634 KiB
HTML
14379 lines
634 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
|
|
<title>API Documentation</title>
|
|
|
|
<link href="https://fonts.googleapis.com/css?family=Open+Sans&display=swap" rel="stylesheet">
|
|
|
|
<link rel="stylesheet" href="./css/theme-default.style.css" media="screen">
|
|
<link rel="stylesheet" href="./css/theme-default.print.css" media="print">
|
|
|
|
<script src="https://cdn.jsdelivr.net/npm/lodash@4.17.10/lodash.min.js"></script>
|
|
|
|
<link rel="stylesheet"
|
|
href="https://unpkg.com/@highlightjs/cdn-assets@11.6.0/styles/obsidian.min.css">
|
|
<script src="https://unpkg.com/@highlightjs/cdn-assets@11.6.0/highlight.min.js"></script>
|
|
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/jets/0.14.1/jets.min.js"></script>
|
|
|
|
<style id="language-style">
|
|
/* starts out as display none and is replaced with js later */
|
|
body .content .bash-example code { display: none; }
|
|
body .content .php-example code { display: none; }
|
|
body .content .javascript-example code { display: none; }
|
|
</style>
|
|
|
|
<script>
|
|
var tryItOutBaseUrl = "https://vito.test";
|
|
var useCsrf = Boolean();
|
|
var csrfUrl = "/sanctum/csrf-cookie";
|
|
</script>
|
|
<script src="./js/tryitout-4.40.0.js"></script>
|
|
|
|
<script src="./js/theme-default-4.40.0.js"></script>
|
|
|
|
</head>
|
|
|
|
<body data-languages="["bash","php","javascript"]">
|
|
|
|
<a href="#" id="nav-button">
|
|
<span>
|
|
MENU
|
|
<img src="./images/navbar.png" alt="navbar-image"/>
|
|
</span>
|
|
</a>
|
|
<div class="tocify-wrapper">
|
|
|
|
<div class="lang-selector">
|
|
<button type="button" class="lang-button" data-language-name="bash">bash</button>
|
|
<button type="button" class="lang-button" data-language-name="php">php</button>
|
|
<button type="button" class="lang-button" data-language-name="javascript">javascript</button>
|
|
</div>
|
|
|
|
<div class="search">
|
|
<input type="text" class="search" id="input-search" placeholder="Search">
|
|
</div>
|
|
|
|
<div id="toc">
|
|
<ul id="tocify-header-introduction" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="introduction">
|
|
<a href="#introduction">Introduction</a>
|
|
</li>
|
|
</ul>
|
|
<ul id="tocify-header-authenticating-requests" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="authenticating-requests">
|
|
<a href="#authenticating-requests">Authenticating requests</a>
|
|
</li>
|
|
</ul>
|
|
<ul id="tocify-header-cron-jobs" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="cron-jobs">
|
|
<a href="#cron-jobs">cron-jobs</a>
|
|
</li>
|
|
<ul id="tocify-subheader-cron-jobs" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="cron-jobs-GETapi-projects--project_id--servers--server_id--cron-jobs">
|
|
<a href="#cron-jobs-GETapi-projects--project_id--servers--server_id--cron-jobs">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="cron-jobs-POSTapi-projects--project_id--servers--server_id--cron-jobs">
|
|
<a href="#cron-jobs-POSTapi-projects--project_id--servers--server_id--cron-jobs">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="cron-jobs-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
<a href="#cron-jobs-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="cron-jobs-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
<a href="#cron-jobs-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-database-users" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="database-users">
|
|
<a href="#database-users">database-users</a>
|
|
</li>
|
|
<ul id="tocify-subheader-database-users" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="database-users-GETapi-projects--project_id--servers--server_id--database-users">
|
|
<a href="#database-users-GETapi-projects--project_id--servers--server_id--database-users">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="database-users-POSTapi-projects--project_id--servers--server_id--database-users">
|
|
<a href="#database-users-POSTapi-projects--project_id--servers--server_id--database-users">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="database-users-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
<a href="#database-users-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="database-users-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link">
|
|
<a href="#database-users-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link">link</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="database-users-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
<a href="#database-users-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-databases" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="databases">
|
|
<a href="#databases">databases</a>
|
|
</li>
|
|
<ul id="tocify-subheader-databases" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="databases-GETapi-projects--project_id--servers--server_id--databases">
|
|
<a href="#databases-GETapi-projects--project_id--servers--server_id--databases">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="databases-POSTapi-projects--project_id--servers--server_id--databases">
|
|
<a href="#databases-POSTapi-projects--project_id--servers--server_id--databases">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="databases-GETapi-projects--project_id--servers--server_id--databases--id-">
|
|
<a href="#databases-GETapi-projects--project_id--servers--server_id--databases--id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="databases-DELETEapi-projects--project_id--servers--server_id--databases--database_id-">
|
|
<a href="#databases-DELETEapi-projects--project_id--servers--server_id--databases--database_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-firewall-rules" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="firewall-rules">
|
|
<a href="#firewall-rules">firewall-rules</a>
|
|
</li>
|
|
<ul id="tocify-subheader-firewall-rules" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="firewall-rules-GETapi-projects--project_id--servers--server_id--firewall-rules">
|
|
<a href="#firewall-rules-GETapi-projects--project_id--servers--server_id--firewall-rules">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="firewall-rules-POSTapi-projects--project_id--servers--server_id--firewall-rules">
|
|
<a href="#firewall-rules-POSTapi-projects--project_id--servers--server_id--firewall-rules">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="firewall-rules-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<a href="#firewall-rules-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">edit</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="firewall-rules-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<a href="#firewall-rules-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="firewall-rules-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<a href="#firewall-rules-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-general" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="general">
|
|
<a href="#general">general</a>
|
|
</li>
|
|
<ul id="tocify-subheader-general" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="general-GETapi-health">
|
|
<a href="#general-GETapi-health">health-check</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-projects" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="projects">
|
|
<a href="#projects">projects</a>
|
|
</li>
|
|
<ul id="tocify-subheader-projects" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="projects-GETapi-projects">
|
|
<a href="#projects-GETapi-projects">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="projects-POSTapi-projects">
|
|
<a href="#projects-POSTapi-projects">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="projects-GETapi-projects--id-">
|
|
<a href="#projects-GETapi-projects--id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="projects-PUTapi-projects--id-">
|
|
<a href="#projects-PUTapi-projects--id-">update</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="projects-DELETEapi-projects--project_id-">
|
|
<a href="#projects-DELETEapi-projects--project_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-redirects" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="redirects">
|
|
<a href="#redirects">redirects</a>
|
|
</li>
|
|
<ul id="tocify-subheader-redirects" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="redirects-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
<a href="#redirects-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects">index</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="redirects-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
<a href="#redirects-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="redirects-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-">
|
|
<a href="#redirects-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-server-providers" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="server-providers">
|
|
<a href="#server-providers">server-providers</a>
|
|
</li>
|
|
<ul id="tocify-subheader-server-providers" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="server-providers-GETapi-projects--project_id--server-providers">
|
|
<a href="#server-providers-GETapi-projects--project_id--server-providers">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="server-providers-POSTapi-projects--project_id--server-providers">
|
|
<a href="#server-providers-POSTapi-projects--project_id--server-providers">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="server-providers-GETapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<a href="#server-providers-GETapi-projects--project_id--server-providers--serverProvider_id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="server-providers-PUTapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<a href="#server-providers-PUTapi-projects--project_id--server-providers--serverProvider_id-">update</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="server-providers-DELETEapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<a href="#server-providers-DELETEapi-projects--project_id--server-providers--serverProvider_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-servers" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="servers">
|
|
<a href="#servers">servers</a>
|
|
</li>
|
|
<ul id="tocify-subheader-servers" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="servers-GETapi-projects--project_id--servers">
|
|
<a href="#servers-GETapi-projects--project_id--servers">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="servers-POSTapi-projects--project_id--servers">
|
|
<a href="#servers-POSTapi-projects--project_id--servers">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="servers-GETapi-projects--project_id--servers--id-">
|
|
<a href="#servers-GETapi-projects--project_id--servers--id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="servers-POSTapi-projects--project_id--servers--server_id--reboot">
|
|
<a href="#servers-POSTapi-projects--project_id--servers--server_id--reboot">reboot</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="servers-POSTapi-projects--project_id--servers--server_id--upgrade">
|
|
<a href="#servers-POSTapi-projects--project_id--servers--server_id--upgrade">upgrade</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="servers-DELETEapi-projects--project_id--servers--server_id-">
|
|
<a href="#servers-DELETEapi-projects--project_id--servers--server_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-services" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="services">
|
|
<a href="#services">services</a>
|
|
</li>
|
|
<ul id="tocify-subheader-services" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="services-GETapi-projects--project_id--servers--server_id--services">
|
|
<a href="#services-GETapi-projects--project_id--servers--server_id--services">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-GETapi-projects--project_id--servers--server_id--services--id-">
|
|
<a href="#services-GETapi-projects--project_id--servers--server_id--services--id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-POSTapi-projects--project_id--servers--server_id--services--service_id--start">
|
|
<a href="#services-POSTapi-projects--project_id--servers--server_id--services--service_id--start">start</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-POSTapi-projects--project_id--servers--server_id--services--service_id--stop">
|
|
<a href="#services-POSTapi-projects--project_id--servers--server_id--services--service_id--stop">stop</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-POSTapi-projects--project_id--servers--server_id--services--service_id--restart">
|
|
<a href="#services-POSTapi-projects--project_id--servers--server_id--services--service_id--restart">restart</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-POSTapi-projects--project_id--servers--server_id--services--service_id--enable">
|
|
<a href="#services-POSTapi-projects--project_id--servers--server_id--services--service_id--enable">enable</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-POSTapi-projects--project_id--servers--server_id--services--service_id--disable">
|
|
<a href="#services-POSTapi-projects--project_id--servers--server_id--services--service_id--disable">disable</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="services-DELETEapi-projects--project_id--servers--server_id--services--service_id-">
|
|
<a href="#services-DELETEapi-projects--project_id--servers--server_id--services--service_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-sites" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="sites">
|
|
<a href="#sites">sites</a>
|
|
</li>
|
|
<ul id="tocify-subheader-sites" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="sites-GETapi-projects--project_id--servers--server_id--sites">
|
|
<a href="#sites-GETapi-projects--project_id--servers--server_id--sites">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-POSTapi-projects--project_id--servers--server_id--sites">
|
|
<a href="#sites-POSTapi-projects--project_id--servers--server_id--sites">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-GETapi-projects--project_id--servers--server_id--sites--id-">
|
|
<a href="#sites-GETapi-projects--project_id--servers--server_id--sites--id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-DELETEapi-projects--project_id--servers--server_id--sites--site_id-">
|
|
<a href="#sites-DELETEapi-projects--project_id--servers--server_id--sites--site_id-">delete</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer">
|
|
<a href="#sites-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer">load-balancer</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases">
|
|
<a href="#sites-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases">aliases</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
<a href="#sites-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">deployment-script</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="sites-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
<a href="#sites-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">deployment-script</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-source-controls" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="source-controls">
|
|
<a href="#source-controls">source-controls</a>
|
|
</li>
|
|
<ul id="tocify-subheader-source-controls" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="source-controls-GETapi-projects--project_id--source-controls">
|
|
<a href="#source-controls-GETapi-projects--project_id--source-controls">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="source-controls-POSTapi-projects--project_id--source-controls">
|
|
<a href="#source-controls-POSTapi-projects--project_id--source-controls">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="source-controls-GETapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<a href="#source-controls-GETapi-projects--project_id--source-controls--sourceControl_id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="source-controls-PUTapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<a href="#source-controls-PUTapi-projects--project_id--source-controls--sourceControl_id-">update</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="source-controls-DELETEapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<a href="#source-controls-DELETEapi-projects--project_id--source-controls--sourceControl_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-ssh-keys" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="ssh-keys">
|
|
<a href="#ssh-keys">ssh-keys</a>
|
|
</li>
|
|
<ul id="tocify-subheader-ssh-keys" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="ssh-keys-GETapi-projects--project_id--servers--server_id--ssh-keys">
|
|
<a href="#ssh-keys-GETapi-projects--project_id--servers--server_id--ssh-keys">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="ssh-keys-POSTapi-projects--project_id--servers--server_id--ssh-keys">
|
|
<a href="#ssh-keys-POSTapi-projects--project_id--servers--server_id--ssh-keys">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="ssh-keys-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-">
|
|
<a href="#ssh-keys-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<ul id="tocify-header-storage-providers" class="tocify-header">
|
|
<li class="tocify-item level-1" data-unique="storage-providers">
|
|
<a href="#storage-providers">storage-providers</a>
|
|
</li>
|
|
<ul id="tocify-subheader-storage-providers" class="tocify-subheader">
|
|
<li class="tocify-item level-2" data-unique="storage-providers-GETapi-projects--project_id--storage-providers">
|
|
<a href="#storage-providers-GETapi-projects--project_id--storage-providers">list</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="storage-providers-POSTapi-projects--project_id--storage-providers">
|
|
<a href="#storage-providers-POSTapi-projects--project_id--storage-providers">create</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="storage-providers-GETapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<a href="#storage-providers-GETapi-projects--project_id--storage-providers--storageProvider_id-">show</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="storage-providers-PUTapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<a href="#storage-providers-PUTapi-projects--project_id--storage-providers--storageProvider_id-">update</a>
|
|
</li>
|
|
<li class="tocify-item level-2" data-unique="storage-providers-DELETEapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<a href="#storage-providers-DELETEapi-projects--project_id--storage-providers--storageProvider_id-">delete</a>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
</div>
|
|
|
|
<ul class="toc-footer" id="toc-footer">
|
|
<li style="padding-bottom: 5px;"><a href="./collection.json">View Postman collection</a></li>
|
|
<li style="padding-bottom: 5px;"><a href="./openapi.yaml">View OpenAPI spec</a></li>
|
|
<li><a href="http://github.com/knuckleswtf/scribe">Documentation powered by Scribe ✍</a></li>
|
|
</ul>
|
|
|
|
<ul class="toc-footer" id="last-updated">
|
|
<li>Last updated: March 31, 2025</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="page-wrapper">
|
|
<div class="dark-box"></div>
|
|
<div class="content">
|
|
<h1 id="introduction">Introduction</h1>
|
|
<p>VitoDeploy's API documentation.</p>
|
|
<aside>
|
|
<strong>Base URL</strong>: <code>https://your-vito-url</code>
|
|
</aside>
|
|
<p>This documentation aims to provide all the information you need to work with our API.</p>
|
|
<aside>As you scroll, you'll see code examples for working with the API in different programming languages in the dark area to the right (or as part of the content on mobile).
|
|
You can switch the language used with the tabs at the top right (or from the nav menu at the top left on mobile).</aside>
|
|
|
|
<h1 id="authenticating-requests">Authenticating requests</h1>
|
|
<p>To authenticate requests, include an <strong><code>Authorization</code></strong> header with the value <strong><code>"Bearer YOUR-API-KEY"</code></strong>.</p>
|
|
<p>All authenticated endpoints are marked with a <code>requires authentication</code> badge in the documentation below.</p>
|
|
<p>You can retrieve your token by visiting <a href="/settings/api-keys" target="_blank">here</a></p>
|
|
|
|
<h1 id="cron-jobs">cron-jobs</h1>
|
|
|
|
|
|
|
|
<h2 id="cron-jobs-GETapi-projects--project_id--servers--server_id--cron-jobs">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all cron jobs.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--cron-jobs">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--cron-jobs">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"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
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--cron-jobs" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--cron-jobs"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--cron-jobs" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--cron-jobs">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--cron-jobs" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/cron-jobs"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--cron-jobs', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--cron-jobs');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--cron-jobs');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/cron-jobs</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="cron-jobs-POSTapi-projects--project_id--servers--server_id--cron-jobs">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new cron job.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--cron-jobs">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/cron-jobs" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"command\": \"sit\",
|
|
\"user\": \"root\",
|
|
\"frequency\": \"* * * * *\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'command' => 'sit',
|
|
'user' => 'root',
|
|
'frequency' => '* * * * *',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/cron-jobs"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"command": "sit",
|
|
"user": "root",
|
|
"frequency": "* * * * *"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--cron-jobs">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"command": "ls -la",
|
|
"user": "root",
|
|
"frequency": "* * * * *",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--cron-jobs" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--cron-jobs"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--cron-jobs" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--cron-jobs">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--cron-jobs" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/cron-jobs"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--cron-jobs', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--cron-jobs');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--cron-jobs');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/cron-jobs</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>command</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="command" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="sit"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>sit</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>user</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="user" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="root"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>root</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>root</code></li> <li><code>vito</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>frequency</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="frequency" data-endpoint="POSTapi-projects--project_id--servers--server_id--cron-jobs"
|
|
value="* * * * *"
|
|
data-component="body">
|
|
<br>
|
|
<p>Frequency of the cron job. Example: <code>* * * * *</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="cron-jobs-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a cron job by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/projects/1/servers/29/cron-jobs/13" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs/13';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/cron-jobs/13"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "GET",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"command": "ls -la",
|
|
"user": "root",
|
|
"frequency": "* * * * *",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/cron-jobs/{cronJob_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/cron-jobs/{cronJob_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>cronJob_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="cronJob_id" data-endpoint="GETapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="13"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the cronJob. Example: <code>13</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="cron-jobs-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete cron job.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request DELETE \
|
|
"https://your-vito-url/api/projects/1/servers/29/cron-jobs/16" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/cron-jobs/16';
|
|
$response = $client->delete(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/cron-jobs/16"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "DELETE",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/cron-jobs/{cronJob_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/cron-jobs/{cronJob_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>cronJob_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="cronJob_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--cron-jobs--cronJob_id-"
|
|
value="16"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the cronJob. Example: <code>16</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="database-users">database-users</h1>
|
|
|
|
|
|
|
|
<h2 id="database-users-GETapi-projects--project_id--servers--server_id--database-users">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all database users.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--database-users">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--database-users">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"username": "imurray",
|
|
"databases": [],
|
|
"host": "%",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"username": "raleigh.heidenreich",
|
|
"databases": [],
|
|
"host": "%",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--database-users" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--database-users"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--database-users"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--database-users" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--database-users">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--database-users" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/database-users"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--database-users', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--database-users"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--database-users');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--database-users"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--database-users');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--database-users"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/database-users</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="database-users-POSTapi-projects--project_id--servers--server_id--database-users">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new database user.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--database-users">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"username\": \"ut\",
|
|
\"password\": \"L&1)4X-w>&T=:\'Y2#x\",
|
|
\"host\": \"%\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'username' => 'ut',
|
|
'password' => 'L&1)4X-w>&T=:\'Y2#x',
|
|
'host' => '%',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"username": "ut",
|
|
"password": "L&1)4X-w>&T=:'Y2#x",
|
|
"host": "%"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--database-users">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"username": "kbernhard",
|
|
"databases": [],
|
|
"host": "%",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--database-users" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--database-users"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--database-users"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--database-users" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--database-users">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--database-users" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/database-users"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--database-users', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--database-users"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--database-users');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--database-users"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--database-users');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--database-users"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/database-users</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>username</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="username" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="ut"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>ut</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>password</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="password" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="L&1)4X-w>&T=:'Y2#x"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>L&1)4X-w>&T=:'Y2#x</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>host</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="host" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users"
|
|
value="%"
|
|
data-component="body">
|
|
<br>
|
|
<p>Host, if it is a remote user. Example: <code>%</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="database-users-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a database user by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/projects/1/servers/29/database-users/8" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users/8';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users/8"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "GET",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"username": "lavada.casper",
|
|
"databases": [],
|
|
"host": "%",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>databaseUser_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="databaseUser_id" data-endpoint="GETapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="8"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the databaseUser. Example: <code>8</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="database-users-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link">link</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Link to databases</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users/3/link" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"databases\": \"laboriosam\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users/3/link';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'databases' => 'laboriosam',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users/3/link"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"databases": "laboriosam"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"username": "ojerde",
|
|
"databases": [],
|
|
"host": "%",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}/link"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}/link</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>databaseUser_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="databaseUser_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the databaseUser. Example: <code>3</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>databases</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="databases" data-endpoint="POSTapi-projects--project_id--servers--server_id--database-users--databaseUser_id--link"
|
|
value="laboriosam"
|
|
data-component="body">
|
|
<br>
|
|
<p>Array of database names to link to the user. Example: <code>laboriosam</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="database-users-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete database user.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request DELETE \
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users/8" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/database-users/8';
|
|
$response = $client->delete(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/database-users/8"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "DELETE",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/database-users/{databaseUser_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>databaseUser_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="databaseUser_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--database-users--databaseUser_id-"
|
|
value="8"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the databaseUser. Example: <code>8</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="databases">databases</h1>
|
|
|
|
|
|
|
|
<h2 id="databases-GETapi-projects--project_id--servers--server_id--databases">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all databases.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--databases">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--databases">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"name": "fkrajcik",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"name": "critchie",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--databases" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--databases"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--databases"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--databases" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--databases">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--databases" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/databases"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--databases', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--databases"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--databases');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--databases"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--databases');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--databases"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/databases</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--databases"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--databases"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--databases"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--databases"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--databases"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="databases-POSTapi-projects--project_id--servers--server_id--databases">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new database.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--databases">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/databases" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"esse\",
|
|
\"charset\": \"ut\",
|
|
\"collation\": \"labore\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/databases';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'esse',
|
|
'charset' => 'ut',
|
|
'collation' => 'labore',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/databases"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "esse",
|
|
"charset": "ut",
|
|
"collation": "labore"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--databases">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"name": "cory33",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--databases" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--databases"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--databases"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--databases" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--databases">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--databases" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/databases"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--databases', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--databases"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--databases');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--databases"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--databases');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--databases"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/databases</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="esse"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>esse</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>charset</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="charset" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="ut"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>ut</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>collation</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="collation" data-endpoint="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="labore"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>labore</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="databases-GETapi-projects--project_id--servers--server_id--databases--id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a database by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--databases--id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/projects/1/servers/29/databases/9" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/databases/9';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/databases/9"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "GET",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--databases--id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"server_id": null,
|
|
"name": "walter.jacey",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--databases--id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--databases--id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--databases--id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--databases--id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--databases--id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/databases/{id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--databases--id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--databases--id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--databases--id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/databases/{id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="id" data-endpoint="GETapi-projects--project_id--servers--server_id--databases--id-"
|
|
value="9"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the database. Example: <code>9</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="databases-DELETEapi-projects--project_id--servers--server_id--databases--database_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete database.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--databases--database_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request DELETE \
|
|
"https://your-vito-url/api/projects/1/servers/29/databases/16" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/databases/16';
|
|
$response = $client->delete(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/databases/16"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "DELETE",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--databases--database_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--databases--database_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--databases--database_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--databases--database_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--databases--database_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--databases--database_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/databases/{database_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--databases--database_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--databases--database_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--databases--database_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/databases/{database_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>database_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="database_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--databases--database_id-"
|
|
value="16"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the database. Example: <code>16</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="firewall-rules">firewall-rules</h1>
|
|
|
|
|
|
|
|
<h2 id="firewall-rules-GETapi-projects--project_id--servers--server_id--firewall-rules">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all firewall rules.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--firewall-rules">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--firewall-rules">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": null,
|
|
"name": "optio",
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 52674,
|
|
"source": "142.10.115.135",
|
|
"mask": 24,
|
|
"note": "test",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"name": "dolores",
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 34607,
|
|
"source": "20.175.64.76",
|
|
"mask": 24,
|
|
"note": "test",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--firewall-rules" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--firewall-rules"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--firewall-rules" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--firewall-rules">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--firewall-rules" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/firewall-rules"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--firewall-rules', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--firewall-rules');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--firewall-rules');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/firewall-rules</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="firewall-rules-POSTapi-projects--project_id--servers--server_id--firewall-rules">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new firewall rule.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--firewall-rules">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/firewall-rules" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"voluptas\",
|
|
\"type\": \"deny\",
|
|
\"protocol\": \"udp\",
|
|
\"port\": \"qui\",
|
|
\"source\": \"amet\",
|
|
\"mask\": \"0\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'voluptas',
|
|
'type' => 'deny',
|
|
'protocol' => 'udp',
|
|
'port' => 'qui',
|
|
'source' => 'amet',
|
|
'mask' => '0',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/firewall-rules"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "voluptas",
|
|
"type": "deny",
|
|
"protocol": "udp",
|
|
"port": "qui",
|
|
"source": "amet",
|
|
"mask": "0"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--firewall-rules">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"name": "molestiae",
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 26783,
|
|
"source": "190.202.255.27",
|
|
"mask": 24,
|
|
"note": "test",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--firewall-rules" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--firewall-rules"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--firewall-rules" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--firewall-rules">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--firewall-rules" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/firewall-rules"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--firewall-rules', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--firewall-rules');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--firewall-rules');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/firewall-rules</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="voluptas"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>voluptas</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>type</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="type" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="deny"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>deny</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>allow</code></li> <li><code>deny</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>protocol</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="protocol" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="udp"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>udp</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>tcp</code></li> <li><code>udp</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>port</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="port" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="qui"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>qui</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>source</code></b>
|
|
<small>string</small>
|
|
<i>optional</i>
|
|
<input type="text" style="display: none"
|
|
name="source" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="amet"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>amet</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>mask</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="mask" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="0"
|
|
data-component="body">
|
|
<br>
|
|
<p>Mask for source IP. Example: <code>0</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="firewall-rules-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">edit</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Update an existing firewall rule.</p>
|
|
|
|
<span id="example-requests-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1/servers/29/firewall-rules/85" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"et\",
|
|
\"type\": \"allow\",
|
|
\"protocol\": \"tcp\",
|
|
\"port\": \"rerum\",
|
|
\"source\": \"sed\",
|
|
\"mask\": \"0\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/firewall-rules/85';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'et',
|
|
'type' => 'allow',
|
|
'protocol' => 'tcp',
|
|
'port' => 'rerum',
|
|
'source' => 'sed',
|
|
'mask' => '0',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/firewall-rules/85"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "et",
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": "rerum",
|
|
"source": "sed",
|
|
"mask": "0"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"name": "labore",
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 29044,
|
|
"source": "113.132.217.224",
|
|
"mask": 24,
|
|
"note": "test",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" data-method="PUT"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
onclick="tryItOut('PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
onclick="cancelTryOut('PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>firewallRule_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="firewallRule_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="85"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the firewallRule. Example: <code>85</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="et"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>et</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>type</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="type" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="allow"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>allow</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>allow</code></li> <li><code>deny</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>protocol</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="protocol" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="tcp"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>tcp</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>tcp</code></li> <li><code>udp</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>port</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="port" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="rerum"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>rerum</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>source</code></b>
|
|
<small>string</small>
|
|
<i>optional</i>
|
|
<input type="text" style="display: none"
|
|
name="source" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="sed"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>sed</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>mask</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="mask" data-endpoint="PUTapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="0"
|
|
data-component="body">
|
|
<br>
|
|
<p>Mask for source IP. Example: <code>0</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="firewall-rules-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a firewall rule by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"name": "ipsa",
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 50679,
|
|
"source": "42.114.67.31",
|
|
"mask": 24,
|
|
"note": "test",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>firewallRule_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="firewallRule_id" data-endpoint="GETapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="85"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the firewallRule. Example: <code>85</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="firewall-rules-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete firewall rule.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/firewall-rules/{firewallRule_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>firewallRule_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="firewallRule_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--firewall-rules--firewallRule_id-"
|
|
value="85"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the firewallRule. Example: <code>85</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="general">general</h1>
|
|
|
|
|
|
|
|
<h2 id="general-GETapi-health">health-check</h2>
|
|
|
|
<p>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-health">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/health" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-health">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<details class="annotation">
|
|
<summary style="cursor: pointer;">
|
|
<small onclick="textContent = parentElement.parentElement.open ? 'Show headers' : 'Hide headers'">Show headers</small>
|
|
</summary>
|
|
<pre><code class="language-http">cache-control: no-cache, private
|
|
content-type: application/json
|
|
x-ratelimit-limit: 60
|
|
x-ratelimit-remaining: 58
|
|
access-control-allow-origin: *
|
|
</code></pre></details> <pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"success": true,
|
|
"version": "2.4.0"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-health" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-health"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-health"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-health" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-health">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-health" data-method="GET"
|
|
data-path="api/health"
|
|
data-authed="0"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-health', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-health"
|
|
onclick="tryItOut('GETapi-health');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-health"
|
|
onclick="cancelTryOut('GETapi-health');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-health"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/health</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-health"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-health"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="projects">projects</h1>
|
|
|
|
|
|
|
|
<h2 id="projects-GETapi-projects">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all projects.</p>
|
|
|
|
<span id="example-requests-GETapi-projects">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": 3,
|
|
"name": "Kattie Haley",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
},
|
|
{
|
|
"id": 4,
|
|
"name": "Kailyn Kiehn",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects" data-method="GET"
|
|
data-path="api/projects"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects"
|
|
onclick="tryItOut('GETapi-projects');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects"
|
|
onclick="cancelTryOut('GETapi-projects');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="projects-POSTapi-projects">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new project.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"excepturi\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'excepturi',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "excepturi"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 3,
|
|
"name": "Dayne White",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects" data-method="POST"
|
|
data-path="api/projects"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects"
|
|
onclick="tryItOut('POSTapi-projects');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects"
|
|
onclick="cancelTryOut('POSTapi-projects');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects"
|
|
value="excepturi"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the project. Example: <code>excepturi</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="projects-GETapi-projects--id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a project by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 3,
|
|
"name": "Cheyenne Ankunding III",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--id-" data-method="GET"
|
|
data-path="api/projects/{id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--id-"
|
|
onclick="tryItOut('GETapi-projects--id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--id-"
|
|
onclick="cancelTryOut('GETapi-projects--id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="id" data-endpoint="GETapi-projects--id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="projects-PUTapi-projects--id-">update</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Update project.</p>
|
|
|
|
<span id="example-requests-PUTapi-projects--id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"mollitia\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'mollitia',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "mollitia"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 3,
|
|
"name": "Susanna Stark",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--id-" data-method="PUT"
|
|
data-path="api/projects/{id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--id-"
|
|
onclick="tryItOut('PUTapi-projects--id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--id-"
|
|
onclick="cancelTryOut('PUTapi-projects--id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="id" data-endpoint="PUTapi-projects--id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="PUTapi-projects--id-"
|
|
value="mollitia"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the project. Example: <code>mollitia</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="projects-DELETEapi-projects--project_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete project.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="redirects">redirects</h1>
|
|
|
|
|
|
|
|
<h2 id="redirects-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects">index</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all redirects.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/projects/1/servers/29/sites/11/redirects" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/11/redirects';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/11/redirects"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "GET",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": null,
|
|
"site_id": null,
|
|
"mode": 301,
|
|
"from": "error",
|
|
"to": "https://www.pfannerstill.com/facere-est-totam-laudantium-in-illo-sequi",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"site_id": null,
|
|
"mode": 301,
|
|
"from": "repellat",
|
|
"to": "http://gislason.biz/sed-corrupti-et-id-earum-qui-consequatur-quis-voluptas.html",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--sites--site_id--redirects', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--sites--site_id--redirects');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--sites--site_id--redirects');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="11"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>11</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="redirects-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new redirect.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/11/redirects" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"from\": \"vel\",
|
|
\"to\": \"ea\",
|
|
\"mode\": 307
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/11/redirects';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'from' => 'vel',
|
|
'to' => 'ea',
|
|
'mode' => 307,
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/11/redirects"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"from": "vel",
|
|
"to": "ea",
|
|
"mode": 307
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;"></code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="11"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>11</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>from</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="from" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="vel"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>vel</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>to</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="to" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="ea"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>ea</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>mode</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="mode" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--redirects"
|
|
value="307"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>307</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>301</code></li> <li><code>302</code></li> <li><code>307</code></li> <li><code>308</code></li></ul>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="redirects-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete a redirect.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request DELETE \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/11/redirects/9" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/11/redirects/9';
|
|
$response = $client->delete(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/11/redirects/9"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "DELETE",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects/{redirect_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/redirects/{redirect_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="11"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>11</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>redirect_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="redirect_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id--redirects--redirect_id-"
|
|
value="9"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the redirect. Example: <code>9</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="server-providers">server-providers</h1>
|
|
|
|
|
|
|
|
<h2 id="server-providers-GETapi-projects--project_id--server-providers">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--server-providers">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--server-providers">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "id",
|
|
"provider": "custom",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
},
|
|
{
|
|
"id": 4,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "culpa",
|
|
"provider": "linode",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--server-providers" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--server-providers"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--server-providers"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--server-providers" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--server-providers">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--server-providers" data-method="GET"
|
|
data-path="api/projects/{project_id}/server-providers"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--server-providers', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--server-providers"
|
|
onclick="tryItOut('GETapi-projects--project_id--server-providers');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--server-providers"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--server-providers');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--server-providers"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/server-providers</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--server-providers"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--server-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--server-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--server-providers"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="server-providers-POSTapi-projects--project_id--server-providers">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--server-providers">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/server-providers" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"provider\": \"mollitia\",
|
|
\"name\": \"adipisci\",
|
|
\"token\": \"animi\",
|
|
\"key\": \"provident\",
|
|
\"secret\": \"deserunt\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/server-providers';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'provider' => 'mollitia',
|
|
'name' => 'adipisci',
|
|
'token' => 'animi',
|
|
'key' => 'provident',
|
|
'secret' => 'deserunt',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/server-providers"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"provider": "mollitia",
|
|
"name": "adipisci",
|
|
"token": "animi",
|
|
"key": "provident",
|
|
"secret": "deserunt"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--server-providers">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "et",
|
|
"provider": "vultr",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--server-providers" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--server-providers"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--server-providers"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--server-providers" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--server-providers">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--server-providers" data-method="POST"
|
|
data-path="api/projects/{project_id}/server-providers"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--server-providers', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--server-providers"
|
|
onclick="tryItOut('POSTapi-projects--project_id--server-providers');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--server-providers"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--server-providers');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--server-providers"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/server-providers</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>provider</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="provider" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="mollitia"
|
|
data-component="body">
|
|
<br>
|
|
<p>The provider (aws, linode, hetzner, digitalocean, vultr, ...) Example: <code>mollitia</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="adipisci"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the server provider. Example: <code>adipisci</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>token</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="token" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="animi"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>animi</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>key</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="key" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="provident"
|
|
data-component="body">
|
|
<br>
|
|
<p>The key if provider requires key Example: <code>provident</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>secret</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="secret" data-endpoint="POSTapi-projects--project_id--server-providers"
|
|
value="deserunt"
|
|
data-component="body">
|
|
<br>
|
|
<p>The secret if provider requires key Example: <code>deserunt</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="server-providers-GETapi-projects--project_id--server-providers--serverProvider_id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "ab",
|
|
"provider": "digitalocean",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--server-providers--serverProvider_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--server-providers--serverProvider_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--server-providers--serverProvider_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--server-providers--serverProvider_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--server-providers--serverProvider_id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/server-providers/{serverProvider_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--server-providers--serverProvider_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--server-providers--serverProvider_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--server-providers--serverProvider_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/server-providers/{serverProvider_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>serverProvider_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="serverProvider_id" data-endpoint="GETapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the serverProvider. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="server-providers-PUTapi-projects--project_id--server-providers--serverProvider_id-">update</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-PUTapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1/server-providers/1" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"eveniet\",
|
|
\"global\": false
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/server-providers/1';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'eveniet',
|
|
'global' => false,
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/server-providers/1"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "eveniet",
|
|
"global": false
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "expedita",
|
|
"provider": "aws",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--project_id--server-providers--serverProvider_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--project_id--server-providers--serverProvider_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--project_id--server-providers--serverProvider_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--project_id--server-providers--serverProvider_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--project_id--server-providers--serverProvider_id-" data-method="PUT"
|
|
data-path="api/projects/{project_id}/server-providers/{serverProvider_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--project_id--server-providers--serverProvider_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
onclick="tryItOut('PUTapi-projects--project_id--server-providers--serverProvider_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
onclick="cancelTryOut('PUTapi-projects--project_id--server-providers--serverProvider_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{project_id}/server-providers/{serverProvider_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>serverProvider_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="serverProvider_id" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the serverProvider. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="eveniet"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the server provider. Example: <code>eveniet</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>global</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="global" data-endpoint="PUTapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value=""
|
|
data-component="body">
|
|
<br>
|
|
<p>Accessible in all projects Example: <code>false</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>1</code></li> <li><code></code></li></ul>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="server-providers-DELETEapi-projects--project_id--server-providers--serverProvider_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--server-providers--serverProvider_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--server-providers--serverProvider_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--server-providers--serverProvider_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--server-providers--serverProvider_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--server-providers--serverProvider_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--server-providers--serverProvider_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/server-providers/{serverProvider_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--server-providers--serverProvider_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--server-providers--serverProvider_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--server-providers--serverProvider_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/server-providers/{serverProvider_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>serverProvider_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="serverProvider_id" data-endpoint="DELETEapi-projects--project_id--server-providers--serverProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the serverProvider. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="servers">servers</h1>
|
|
|
|
|
|
|
|
<h2 id="servers-GETapi-projects--project_id--servers">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all servers in a project.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": null,
|
|
"project_id": null,
|
|
"user_id": null,
|
|
"provider_id": null,
|
|
"name": "Consuelo Connelly",
|
|
"ssh_user": "vito",
|
|
"ip": "80.154.83.232",
|
|
"local_ip": "45.31.117.65",
|
|
"port": 22,
|
|
"os": "ubuntu_22",
|
|
"type": "regular",
|
|
"type_data": null,
|
|
"provider": "custom",
|
|
"provider_data": null,
|
|
"public_key": "test",
|
|
"status": "ready",
|
|
"auto_update": null,
|
|
"available_updates": 0,
|
|
"security_updates": null,
|
|
"progress": 100,
|
|
"progress_step": null,
|
|
"updates": null,
|
|
"last_update_check": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"project_id": null,
|
|
"user_id": null,
|
|
"provider_id": null,
|
|
"name": "Rodolfo Fadel",
|
|
"ssh_user": "vito",
|
|
"ip": "103.227.79.93",
|
|
"local_ip": "33.49.217.56",
|
|
"port": 22,
|
|
"os": "ubuntu_22",
|
|
"type": "regular",
|
|
"type_data": null,
|
|
"provider": "custom",
|
|
"provider_data": null,
|
|
"public_key": "test",
|
|
"status": "ready",
|
|
"auto_update": null,
|
|
"available_updates": 0,
|
|
"security_updates": null,
|
|
"progress": 100,
|
|
"progress_step": null,
|
|
"updates": null,
|
|
"last_update_check": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="servers-POSTapi-projects--project_id--servers">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new server.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"provider\": \"incidunt\",
|
|
\"server_provider\": \"hetzner\",
|
|
\"region\": \"ut\",
|
|
\"plan\": \"ullam\",
|
|
\"ip\": \"architecto\",
|
|
\"port\": \"praesentium\",
|
|
\"name\": \"facere\",
|
|
\"os\": \"illo\",
|
|
\"webserver\": \"none\",
|
|
\"database\": \"none\",
|
|
\"php\": \"8.1\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'provider' => 'incidunt',
|
|
'server_provider' => 'hetzner',
|
|
'region' => 'ut',
|
|
'plan' => 'ullam',
|
|
'ip' => 'architecto',
|
|
'port' => 'praesentium',
|
|
'name' => 'facere',
|
|
'os' => 'illo',
|
|
'webserver' => 'none',
|
|
'database' => 'none',
|
|
'php' => '8.1',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"provider": "incidunt",
|
|
"server_provider": "hetzner",
|
|
"region": "ut",
|
|
"plan": "ullam",
|
|
"ip": "architecto",
|
|
"port": "praesentium",
|
|
"name": "facere",
|
|
"os": "illo",
|
|
"webserver": "none",
|
|
"database": "none",
|
|
"php": "8.1"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"project_id": null,
|
|
"user_id": null,
|
|
"provider_id": null,
|
|
"name": "Herbert VonRueden",
|
|
"ssh_user": "vito",
|
|
"ip": "91.154.105.143",
|
|
"local_ip": "62.75.177.7",
|
|
"port": 22,
|
|
"os": "ubuntu_22",
|
|
"type": "regular",
|
|
"type_data": null,
|
|
"provider": "custom",
|
|
"provider_data": null,
|
|
"public_key": "test",
|
|
"status": "ready",
|
|
"auto_update": null,
|
|
"available_updates": 0,
|
|
"security_updates": null,
|
|
"progress": 100,
|
|
"progress_step": null,
|
|
"updates": null,
|
|
"last_update_check": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>provider</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="provider" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="incidunt"
|
|
data-component="body">
|
|
<br>
|
|
<p>The server provider type Example: <code>incidunt</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_provider</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="server_provider" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="hetzner"
|
|
data-component="body">
|
|
<br>
|
|
<p>If the provider is not custom, the ID of the server provider profile Example: <code>hetzner</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>custom</code></li> <li><code>hetzner</code></li> <li><code>digitalocean</code></li> <li><code>linode</code></li> <li><code>vultr</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>region</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="region" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="ut"
|
|
data-component="body">
|
|
<br>
|
|
<p>Provider region if the provider is not custom Example: <code>ut</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>plan</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="plan" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="ullam"
|
|
data-component="body">
|
|
<br>
|
|
<p>Provider plan if the provider is not custom Example: <code>ullam</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>ip</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="ip" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="architecto"
|
|
data-component="body">
|
|
<br>
|
|
<p>SSH IP address if the provider is custom Example: <code>architecto</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>port</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="port" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="praesentium"
|
|
data-component="body">
|
|
<br>
|
|
<p>SSH Port if the provider is custom Example: <code>praesentium</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="facere"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the server. Example: <code>facere</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>os</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="os" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="illo"
|
|
data-component="body">
|
|
<br>
|
|
<p>The os of the server Example: <code>illo</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>webserver</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="webserver" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="none"
|
|
data-component="body">
|
|
<br>
|
|
<p>Web server Example: <code>none</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>none</code></li> <li><code>nginx</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>database</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="database" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="none"
|
|
data-component="body">
|
|
<br>
|
|
<p>Database Example: <code>none</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>none</code></li> <li><code>mysql57</code></li> <li><code>mysql80</code></li> <li><code>mariadb103</code></li> <li><code>mariadb104</code></li> <li><code>mariadb103</code></li> <li><code>postgresql12</code></li> <li><code>postgresql13</code></li> <li><code>postgresql14</code></li> <li><code>postgresql15</code></li> <li><code>postgresql16</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>php</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="php" data-endpoint="POSTapi-projects--project_id--servers"
|
|
value="8.1"
|
|
data-component="body">
|
|
<br>
|
|
<p>PHP version Example: <code>8.1</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>7.0</code></li> <li><code>7.1</code></li> <li><code>7.2</code></li> <li><code>7.3</code></li> <li><code>7.4</code></li> <li><code>8.0</code></li> <li><code>8.1</code></li> <li><code>8.2</code></li> <li><code>8.3</code></li></ul>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="servers-GETapi-projects--project_id--servers--id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a server by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"project_id": null,
|
|
"user_id": null,
|
|
"provider_id": null,
|
|
"name": "Connie Simonis",
|
|
"ssh_user": "vito",
|
|
"ip": "202.119.26.253",
|
|
"local_ip": "112.75.79.203",
|
|
"port": 22,
|
|
"os": "ubuntu_22",
|
|
"type": "regular",
|
|
"type_data": null,
|
|
"provider": "custom",
|
|
"provider_data": null,
|
|
"public_key": "test",
|
|
"status": "ready",
|
|
"auto_update": null,
|
|
"available_updates": 0,
|
|
"security_updates": null,
|
|
"progress": 100,
|
|
"progress_step": null,
|
|
"updates": null,
|
|
"last_update_check": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="id" data-endpoint="GETapi-projects--project_id--servers--id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="servers-POSTapi-projects--project_id--servers--server_id--reboot">reboot</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Reboot a server.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--reboot">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--reboot">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--reboot" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--reboot"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--reboot"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--reboot" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--reboot">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--reboot" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/reboot"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--reboot', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--reboot"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--reboot');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--reboot"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--reboot');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--reboot"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/reboot</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--reboot"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--reboot"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--reboot"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--reboot"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--reboot"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="servers-POSTapi-projects--project_id--servers--server_id--upgrade">upgrade</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Upgrade server.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--upgrade">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--upgrade">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--upgrade" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--upgrade"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--upgrade" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--upgrade">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--upgrade" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/upgrade"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--upgrade', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--upgrade');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--upgrade');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/upgrade</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--upgrade"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="servers-DELETEapi-projects--project_id--servers--server_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete server.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="services">services</h1>
|
|
|
|
|
|
|
|
<h2 id="services-GETapi-projects--project_id--servers--server_id--services">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all services.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--services">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--services">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"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
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--services" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--services"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--services"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--services" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--services">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--services" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--services', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--services"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--services');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--services"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--services');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--services"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--services"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--services"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--services"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--services"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--services"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-GETapi-projects--project_id--servers--server_id--services--id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a service by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--services--id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--services--id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"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
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--services--id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--services--id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--services--id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--services--id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--services--id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--services--id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--services--id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--services--id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--services--id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--services--id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--services--id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--services--id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--services--id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--services--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--services--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--services--id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--services--id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="id" data-endpoint="GETapi-projects--project_id--servers--server_id--services--id-"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-POSTapi-projects--project_id--servers--server_id--services--service_id--start">start</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Start service.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--services--service_id--start">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--services--service_id--start">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--services--service_id--start" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--services--service_id--start"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--services--service_id--start" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--services--service_id--start">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--services--service_id--start" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{service_id}/start"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--start', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--services--service_id--start');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--start');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{service_id}/start</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>service_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="service_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--start"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-POSTapi-projects--project_id--servers--server_id--services--service_id--stop">stop</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Stop service.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--services--service_id--stop">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--services--service_id--stop">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--services--service_id--stop" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--services--service_id--stop"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--services--service_id--stop" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--services--service_id--stop">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--services--service_id--stop" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{service_id}/stop"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--stop', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--services--service_id--stop');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--stop');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{service_id}/stop</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>service_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="service_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--stop"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-POSTapi-projects--project_id--servers--server_id--services--service_id--restart">restart</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Restart service.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--services--service_id--restart">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--services--service_id--restart">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--services--service_id--restart" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--services--service_id--restart"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--services--service_id--restart" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--services--service_id--restart">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--services--service_id--restart" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{service_id}/restart"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--restart', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--services--service_id--restart');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--restart');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{service_id}/restart</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>service_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="service_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--restart"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-POSTapi-projects--project_id--servers--server_id--services--service_id--enable">enable</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Enable service.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--services--service_id--enable">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--services--service_id--enable">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--services--service_id--enable" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--services--service_id--enable"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--services--service_id--enable" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--services--service_id--enable">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--services--service_id--enable" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{service_id}/enable"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--enable', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--services--service_id--enable');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--enable');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{service_id}/enable</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>service_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="service_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--enable"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-POSTapi-projects--project_id--servers--server_id--services--service_id--disable">disable</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Disable service.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--services--service_id--disable">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--services--service_id--disable">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--services--service_id--disable" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--services--service_id--disable"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--services--service_id--disable" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--services--service_id--disable">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--services--service_id--disable" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{service_id}/disable"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--disable', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--services--service_id--disable');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--services--service_id--disable');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{service_id}/disable</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>service_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="service_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--services--service_id--disable"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="services-DELETEapi-projects--project_id--servers--server_id--services--service_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete service.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--services--service_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--services--service_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--services--service_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--services--service_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--services--service_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--services--service_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--services--service_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/services/{service_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--services--service_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--services--service_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--services--service_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/services/{service_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>service_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="service_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--services--service_id-"
|
|
value="169"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>169</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="sites">sites</h1>
|
|
|
|
|
|
|
|
<h2 id="sites-GETapi-projects--project_id--servers--server_id--sites">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all sites.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--sites">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--sites">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"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
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--sites" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--sites"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--sites"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--sites" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--sites">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--sites" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--sites', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--sites"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--sites');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--sites"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--sites');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--sites"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--sites"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--sites"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--sites"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-POSTapi-projects--project_id--servers--server_id--sites">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Create a new site.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--sites">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"type\": \"phpmyadmin\",
|
|
\"domain\": \"tenetur\",
|
|
\"aliases\": [
|
|
\"aut\"
|
|
],
|
|
\"php_version\": \"7.4\",
|
|
\"web_directory\": \"public\",
|
|
\"source_control\": \"quasi\",
|
|
\"repository\": \"organization\\/repository\",
|
|
\"branch\": \"main\",
|
|
\"composer\": true,
|
|
\"version\": \"5.2.1\",
|
|
\"user\": \"deleniti\",
|
|
\"method\": \"round-robin\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'type' => 'phpmyadmin',
|
|
'domain' => 'tenetur',
|
|
'aliases' => [
|
|
'aut',
|
|
],
|
|
'php_version' => '7.4',
|
|
'web_directory' => 'public',
|
|
'source_control' => 'quasi',
|
|
'repository' => 'organization/repository',
|
|
'branch' => 'main',
|
|
'composer' => true,
|
|
'version' => '5.2.1',
|
|
'user' => 'deleniti',
|
|
'method' => 'round-robin',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"type": "phpmyadmin",
|
|
"domain": "tenetur",
|
|
"aliases": [
|
|
"aut"
|
|
],
|
|
"php_version": "7.4",
|
|
"web_directory": "public",
|
|
"source_control": "quasi",
|
|
"repository": "organization\/repository",
|
|
"branch": "main",
|
|
"composer": true,
|
|
"version": "5.2.1",
|
|
"user": "deleniti",
|
|
"method": "round-robin"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--sites">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"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
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--sites" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--sites"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--sites"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--sites" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--sites">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--sites" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--sites', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--sites"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--sites');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--sites"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--sites');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--sites"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>type</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="type" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="phpmyadmin"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>phpmyadmin</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>php</code></li> <li><code>php-blank</code></li> <li><code>phpmyadmin</code></li> <li><code>laravel</code></li> <li><code>wordpress</code></li> <li><code>load-balancer</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>domain</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="domain" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="tenetur"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>tenetur</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>aliases</code></b>
|
|
<small>string[]</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="aliases[0]" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
data-component="body">
|
|
<input type="text" style="display: none"
|
|
name="aliases[1]" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
data-component="body">
|
|
<br>
|
|
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>php_version</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="php_version" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="7.4"
|
|
data-component="body">
|
|
<br>
|
|
<p>One of the installed PHP Versions Example: <code>7.4</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>web_directory</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="web_directory" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="public"
|
|
data-component="body">
|
|
<br>
|
|
<p>Required for PHP and Laravel sites Example: <code>public</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>source_control</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="source_control" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="quasi"
|
|
data-component="body">
|
|
<br>
|
|
<p>Source control ID, Required for Sites which support source control Example: <code>quasi</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>repository</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="repository" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="organization/repository"
|
|
data-component="body">
|
|
<br>
|
|
<p>Repository, Required for Sites which support source control Example: <code>organization/repository</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>branch</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="branch" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="main"
|
|
data-component="body">
|
|
<br>
|
|
<p>Branch, Required for Sites which support source control Example: <code>main</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>composer</code></b>
|
|
<small>boolean</small>
|
|
|
|
<label data-endpoint="POSTapi-projects--project_id--servers--server_id--sites" style="display: none">
|
|
<input type="radio" name="composer"
|
|
value="true"
|
|
data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
data-component="body" >
|
|
<code>true</code>
|
|
</label>
|
|
<label data-endpoint="POSTapi-projects--project_id--servers--server_id--sites" style="display: none">
|
|
<input type="radio" name="composer"
|
|
value="false"
|
|
data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
data-component="body" >
|
|
<code>false</code>
|
|
</label>
|
|
<br>
|
|
<p>Run composer if site supports composer Example: <code>true</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>version</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="version" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="5.2.1"
|
|
data-component="body">
|
|
<br>
|
|
<p>Version, if the site type requires a version like PHPMyAdmin Example: <code>5.2.1</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>user</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="user" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="deleniti"
|
|
data-component="body">
|
|
<br>
|
|
<p>user, to isolate the website under a new user Example: <code>deleniti</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>method</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="method" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites"
|
|
value="round-robin"
|
|
data-component="body">
|
|
<br>
|
|
<p>Load balancer method, Required if the site type is Load balancer Example: <code>round-robin</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>round-robin</code></li> <li><code>least-connections</code></li> <li><code>ip-hash</code></li></ul>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-GETapi-projects--project_id--servers--server_id--sites--id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get a site by ID.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--sites--id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/projects/1/servers/29/sites/12" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/12';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/12"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "GET",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--sites--id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"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
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--sites--id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--sites--id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--sites--id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--sites--id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--sites--id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--sites--id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--sites--id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--sites--id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--id-"
|
|
value="12"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>12</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-DELETEapi-projects--project_id--servers--server_id--sites--site_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete site.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--sites--site_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request DELETE \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/9" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/9';
|
|
$response = $client->delete(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/9"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "DELETE",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--sites--site_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--sites--site_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--sites--site_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--sites--site_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--sites--site_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--sites--site_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--sites--site_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--sites--site_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--sites--site_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--sites--site_id-"
|
|
value="9"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>9</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer">load-balancer</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Update load balancer.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/19/load-balancer" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"method\": \"ip-hash\",
|
|
\"servers\": [
|
|
\"dolores\"
|
|
]
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/19/load-balancer';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'method' => 'ip-hash',
|
|
'servers' => [
|
|
'dolores',
|
|
],
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/19/load-balancer"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"method": "ip-hash",
|
|
"servers": [
|
|
"dolores"
|
|
]
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;"></code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/load-balancer"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/load-balancer</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="19"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>19</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>method</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="method" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
value="ip-hash"
|
|
data-component="body">
|
|
<br>
|
|
<p>Load balancer method, Required if the site type is Load balancer Example: <code>ip-hash</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>round-robin</code></li> <li><code>least-connections</code></li> <li><code>ip-hash</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>servers</code></b>
|
|
<small>string[]</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="servers[0]" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
data-component="body">
|
|
<input type="text" style="display: none"
|
|
name="servers[1]" data-endpoint="POSTapi-projects--project_id--servers--server_id--sites--site_id--load-balancer"
|
|
data-component="body">
|
|
<br>
|
|
<p>Array of servers including server, port, weight, backup. (server is the local IP of the server)</p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases">aliases</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Update aliases.</p>
|
|
|
|
<span id="example-requests-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/16/aliases" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"aliases\": [
|
|
\"aut\"
|
|
]
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/16/aliases';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'aliases' => [
|
|
'aut',
|
|
],
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/16/aliases"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"aliases": [
|
|
"aut"
|
|
]
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;"></code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases" data-method="PUT"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/aliases"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
onclick="tryItOut('PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
onclick="cancelTryOut('PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/aliases</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
value="16"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>16</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>aliases</code></b>
|
|
<small>string[]</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="aliases[0]" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
data-component="body">
|
|
<input type="text" style="display: none"
|
|
name="aliases[1]" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--aliases"
|
|
data-component="body">
|
|
<br>
|
|
<p>Array of aliases</p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">deployment-script</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Update site deployment script</p>
|
|
|
|
<span id="example-requests-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/3/deployment-script" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"script\": \"qui\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/3/deployment-script';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'script' => 'qui',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/3/deployment-script"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"script": "qui"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script" data-method="PUT"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/deployment-script"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
onclick="tryItOut('PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
onclick="cancelTryOut('PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/deployment-script</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>3</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>script</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="script" data-endpoint="PUTapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="qui"
|
|
data-component="body">
|
|
<br>
|
|
<p>Content of the deployment script Example: <code>qui</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="sites-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">deployment-script</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get site deployment script content</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request GET \
|
|
--get "https://your-vito-url/api/projects/1/servers/29/sites/16/deployment-script" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/sites/16/deployment-script';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/sites/16/deployment-script"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "GET",
|
|
headers,
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;"></code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/sites/{site_id}/deployment-script"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/sites/{site_id}/deployment-script</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>site_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="site_id" data-endpoint="GETapi-projects--project_id--servers--server_id--sites--site_id--deployment-script"
|
|
value="16"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>16</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="source-controls">source-controls</h1>
|
|
|
|
|
|
|
|
<h2 id="source-controls-GETapi-projects--project_id--source-controls">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--source-controls">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--source-controls">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "Emil Leannon",
|
|
"provider": "github",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
},
|
|
{
|
|
"id": 6,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "Eleazar Pacocha Sr.",
|
|
"provider": "github",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--source-controls" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--source-controls"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--source-controls"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--source-controls" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--source-controls">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--source-controls" data-method="GET"
|
|
data-path="api/projects/{project_id}/source-controls"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--source-controls', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--source-controls"
|
|
onclick="tryItOut('GETapi-projects--project_id--source-controls');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--source-controls"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--source-controls');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--source-controls"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/source-controls</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--source-controls"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--source-controls"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--source-controls"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--source-controls"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="source-controls-POSTapi-projects--project_id--source-controls">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--source-controls">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/source-controls" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"provider\": \"github\",
|
|
\"name\": \"aliquam\",
|
|
\"token\": \"voluptatem\",
|
|
\"url\": \"https:\\/\\/brown.org\\/placeat-optio-illum-eius-ipsa.html\",
|
|
\"username\": \"a\",
|
|
\"password\": \"_\\/_,9\'\\/6z;9\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/source-controls';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'provider' => 'github',
|
|
'name' => 'aliquam',
|
|
'token' => 'voluptatem',
|
|
'url' => 'https://brown.org/placeat-optio-illum-eius-ipsa.html',
|
|
'username' => 'a',
|
|
'password' => '_/_,9\'/6z;9',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/source-controls"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"provider": "github",
|
|
"name": "aliquam",
|
|
"token": "voluptatem",
|
|
"url": "https:\/\/brown.org\/placeat-optio-illum-eius-ipsa.html",
|
|
"username": "a",
|
|
"password": "_\/_,9'\/6z;9"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--source-controls">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "Ahmad Kulas",
|
|
"provider": "github",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--source-controls" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--source-controls"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--source-controls"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--source-controls" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--source-controls">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--source-controls" data-method="POST"
|
|
data-path="api/projects/{project_id}/source-controls"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--source-controls', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--source-controls"
|
|
onclick="tryItOut('POSTapi-projects--project_id--source-controls');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--source-controls"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--source-controls');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--source-controls"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/source-controls</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>provider</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="provider" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="github"
|
|
data-component="body">
|
|
<br>
|
|
<p>The provider Example: <code>github</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>gitlab</code></li> <li><code>github</code></li> <li><code>bitbucket</code></li></ul>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="aliquam"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>aliquam</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>token</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="token" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="voluptatem"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>voluptatem</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>url</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="url" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="https://brown.org/placeat-optio-illum-eius-ipsa.html"
|
|
data-component="body">
|
|
<br>
|
|
<p>The URL if the provider is Gitlab and it is self-hosted Example: <code>https://brown.org/placeat-optio-illum-eius-ipsa.html</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>username</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="username" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="a"
|
|
data-component="body">
|
|
<br>
|
|
<p>The username if the provider is Bitbucket Example: <code>a</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>password</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="password" data-endpoint="POSTapi-projects--project_id--source-controls"
|
|
value="_/_,9'/6z;9"
|
|
data-component="body">
|
|
<br>
|
|
<p>The password if the provider is Bitbucket Example: <code>_/_,9'/6z;9</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="source-controls-GETapi-projects--project_id--source-controls--sourceControl_id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "Mr. Marquis Kunde IV",
|
|
"provider": "github",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--source-controls--sourceControl_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--source-controls--sourceControl_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--source-controls--sourceControl_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--source-controls--sourceControl_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--source-controls--sourceControl_id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/source-controls/{sourceControl_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--source-controls--sourceControl_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--source-controls--sourceControl_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--source-controls--sourceControl_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/source-controls/{sourceControl_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>sourceControl_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="sourceControl_id" data-endpoint="GETapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sourceControl. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="source-controls-PUTapi-projects--project_id--source-controls--sourceControl_id-">update</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-PUTapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1/source-controls/1" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"laudantium\",
|
|
\"token\": \"nulla\",
|
|
\"url\": \"http:\\/\\/wiza.com\\/\",
|
|
\"username\": \"numquam\",
|
|
\"password\": \"MlD,$m:8^A\",
|
|
\"global\": false
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/source-controls/1';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'laudantium',
|
|
'token' => 'nulla',
|
|
'url' => 'http://wiza.com/',
|
|
'username' => 'numquam',
|
|
'password' => 'MlD,$m:8^A',
|
|
'global' => false,
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/source-controls/1"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "laudantium",
|
|
"token": "nulla",
|
|
"url": "http:\/\/wiza.com\/",
|
|
"username": "numquam",
|
|
"password": "MlD,$m:8^A",
|
|
"global": false
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "Mrs. Arvilla Mitchell",
|
|
"provider": "github",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--project_id--source-controls--sourceControl_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--project_id--source-controls--sourceControl_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--project_id--source-controls--sourceControl_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--project_id--source-controls--sourceControl_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--project_id--source-controls--sourceControl_id-" data-method="PUT"
|
|
data-path="api/projects/{project_id}/source-controls/{sourceControl_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--project_id--source-controls--sourceControl_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
onclick="tryItOut('PUTapi-projects--project_id--source-controls--sourceControl_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
onclick="cancelTryOut('PUTapi-projects--project_id--source-controls--sourceControl_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{project_id}/source-controls/{sourceControl_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>sourceControl_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="sourceControl_id" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sourceControl. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="laudantium"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>laudantium</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>token</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="token" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="nulla"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>nulla</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>url</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="url" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="http://wiza.com/"
|
|
data-component="body">
|
|
<br>
|
|
<p>The URL if the provider is Gitlab and it is self-hosted Example: <code>http://wiza.com/</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>username</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="username" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="numquam"
|
|
data-component="body">
|
|
<br>
|
|
<p>The username if the provider is Bitbucket Example: <code>numquam</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>password</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="password" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="MlD,$m:8^A"
|
|
data-component="body">
|
|
<br>
|
|
<p>The password if the provider is Bitbucket Example: <code>MlD,$m:8^A</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>global</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="global" data-endpoint="PUTapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value=""
|
|
data-component="body">
|
|
<br>
|
|
<p>Accessible in all projects Example: <code>false</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>1</code></li> <li><code></code></li></ul>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="source-controls-DELETEapi-projects--project_id--source-controls--sourceControl_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--source-controls--sourceControl_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--source-controls--sourceControl_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--source-controls--sourceControl_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--source-controls--sourceControl_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--source-controls--sourceControl_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--source-controls--sourceControl_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/source-controls/{sourceControl_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--source-controls--sourceControl_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--source-controls--sourceControl_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--source-controls--sourceControl_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/source-controls/{sourceControl_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>sourceControl_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="sourceControl_id" data-endpoint="DELETEapi-projects--project_id--source-controls--sourceControl_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sourceControl. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="ssh-keys">ssh-keys</h1>
|
|
|
|
|
|
|
|
<h2 id="ssh-keys-GETapi-projects--project_id--servers--server_id--ssh-keys">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Get all ssh keys.</p>
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--servers--server_id--ssh-keys">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--servers--server_id--ssh-keys">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": null,
|
|
"user": null,
|
|
"name": "Dr. Pansy Kunde DVM",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"user": null,
|
|
"name": "Ms. Maximillia DuBuque Sr.",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--servers--server_id--ssh-keys" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--servers--server_id--ssh-keys"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--servers--server_id--ssh-keys" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--servers--server_id--ssh-keys">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--servers--server_id--ssh-keys" data-method="GET"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/ssh-keys"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--servers--server_id--ssh-keys', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
onclick="tryItOut('GETapi-projects--project_id--servers--server_id--ssh-keys');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--servers--server_id--ssh-keys');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/ssh-keys</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="GETapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="ssh-keys-POSTapi-projects--project_id--servers--server_id--ssh-keys">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Deploy ssh key to server.</p>
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--servers--server_id--ssh-keys">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/servers/29/ssh-keys" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"key_id\": \"debitis\",
|
|
\"name\": \"illum\",
|
|
\"public_key\": \"dignissimos\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/servers/29/ssh-keys';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'key_id' => 'debitis',
|
|
'name' => 'illum',
|
|
'public_key' => 'dignissimos',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/29/ssh-keys"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"key_id": "debitis",
|
|
"name": "illum",
|
|
"public_key": "dignissimos"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--servers--server_id--ssh-keys">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": null,
|
|
"user": null,
|
|
"name": "Uriah Harvey",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--servers--server_id--ssh-keys" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--servers--server_id--ssh-keys"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--servers--server_id--ssh-keys" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--servers--server_id--ssh-keys">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--servers--server_id--ssh-keys" data-method="POST"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/ssh-keys"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--servers--server_id--ssh-keys', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
onclick="tryItOut('POSTapi-projects--project_id--servers--server_id--ssh-keys');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--servers--server_id--ssh-keys');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/ssh-keys</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>key_id</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="key_id" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="debitis"
|
|
data-component="body">
|
|
<br>
|
|
<p>The ID of the key. Example: <code>debitis</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="illum"
|
|
data-component="body">
|
|
<br>
|
|
<p>Key name, required if key_id is not provided. Example: <code>illum</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>public_key</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="public_key" data-endpoint="POSTapi-projects--project_id--servers--server_id--ssh-keys"
|
|
value="dignissimos"
|
|
data-component="body">
|
|
<br>
|
|
<p>Public Key, required if key_id is not provided. Example: <code>dignissimos</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="ssh-keys-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
<p>Delete ssh key from server.</p>
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/servers/{server_id}/ssh-keys/{sshKey_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/servers/{server_id}/ssh-keys/{sshKey_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>server_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="server_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
value="29"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>29</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>sshKey_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="sshKey_id" data-endpoint="DELETEapi-projects--project_id--servers--server_id--ssh-keys--sshKey_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sshKey. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h1 id="storage-providers">storage-providers</h1>
|
|
|
|
|
|
|
|
<h2 id="storage-providers-GETapi-projects--project_id--storage-providers">list</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--storage-providers">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--storage-providers">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"data": [
|
|
{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "autem",
|
|
"provider": "s3",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
},
|
|
{
|
|
"id": 6,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "nihil",
|
|
"provider": "ftp",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}
|
|
],
|
|
"links": {
|
|
"first": "/?page=1",
|
|
"last": "/?page=1",
|
|
"prev": null,
|
|
"next": null
|
|
},
|
|
"meta": {
|
|
"current_page": 1,
|
|
"from": 1,
|
|
"last_page": 1,
|
|
"links": [
|
|
{
|
|
"url": null,
|
|
"label": "&laquo; Previous",
|
|
"active": false
|
|
},
|
|
{
|
|
"url": "/?page=1",
|
|
"label": "1",
|
|
"active": true
|
|
},
|
|
{
|
|
"url": null,
|
|
"label": "Next &raquo;",
|
|
"active": false
|
|
}
|
|
],
|
|
"path": "/",
|
|
"per_page": 25,
|
|
"to": 2,
|
|
"total": 2
|
|
}
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--storage-providers" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--storage-providers"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--storage-providers"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--storage-providers" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--storage-providers">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--storage-providers" data-method="GET"
|
|
data-path="api/projects/{project_id}/storage-providers"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--storage-providers', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--storage-providers"
|
|
onclick="tryItOut('GETapi-projects--project_id--storage-providers');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--storage-providers"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--storage-providers');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--storage-providers"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/storage-providers</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--storage-providers"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--storage-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--storage-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--storage-providers"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="storage-providers-POSTapi-projects--project_id--storage-providers">create</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-POSTapi-projects--project_id--storage-providers">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request POST \
|
|
"https://your-vito-url/api/projects/1/storage-providers" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"provider\": \"est\",
|
|
\"name\": \"voluptatem\",
|
|
\"token\": \"delectus\",
|
|
\"key\": \"natus\",
|
|
\"secret\": \"saepe\"
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/storage-providers';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'provider' => 'est',
|
|
'name' => 'voluptatem',
|
|
'token' => 'delectus',
|
|
'key' => 'natus',
|
|
'secret' => 'saepe',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/storage-providers"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"provider": "est",
|
|
"name": "voluptatem",
|
|
"token": "delectus",
|
|
"key": "natus",
|
|
"secret": "saepe"
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "POST",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-POSTapi-projects--project_id--storage-providers">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "omnis",
|
|
"provider": "local",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-POSTapi-projects--project_id--storage-providers" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-POSTapi-projects--project_id--storage-providers"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-POSTapi-projects--project_id--storage-providers"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-POSTapi-projects--project_id--storage-providers" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-POSTapi-projects--project_id--storage-providers">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-POSTapi-projects--project_id--storage-providers" data-method="POST"
|
|
data-path="api/projects/{project_id}/storage-providers"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('POSTapi-projects--project_id--storage-providers', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-POSTapi-projects--project_id--storage-providers"
|
|
onclick="tryItOut('POSTapi-projects--project_id--storage-providers');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-POSTapi-projects--project_id--storage-providers"
|
|
onclick="cancelTryOut('POSTapi-projects--project_id--storage-providers');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-POSTapi-projects--project_id--storage-providers"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-black">POST</small>
|
|
<b><code>api/projects/{project_id}/storage-providers</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>provider</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="provider" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="est"
|
|
data-component="body">
|
|
<br>
|
|
<p>The provider (aws, linode, hetzner, digitalocean, vultr, ...) Example: <code>est</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="voluptatem"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>voluptatem</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>token</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="token" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="delectus"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>delectus</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>key</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="key" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="natus"
|
|
data-component="body">
|
|
<br>
|
|
<p>The key if provider requires key Example: <code>natus</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>secret</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="secret" data-endpoint="POSTapi-projects--project_id--storage-providers"
|
|
value="saepe"
|
|
data-component="body">
|
|
<br>
|
|
<p>The secret if provider requires key Example: <code>saepe</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="storage-providers-GETapi-projects--project_id--storage-providers--storageProvider_id-">show</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-GETapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-GETapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "molestiae",
|
|
"provider": "dropbox",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-GETapi-projects--project_id--storage-providers--storageProvider_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-GETapi-projects--project_id--storage-providers--storageProvider_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-GETapi-projects--project_id--storage-providers--storageProvider_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-GETapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-GETapi-projects--project_id--storage-providers--storageProvider_id-" data-method="GET"
|
|
data-path="api/projects/{project_id}/storage-providers/{storageProvider_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('GETapi-projects--project_id--storage-providers--storageProvider_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
onclick="tryItOut('GETapi-projects--project_id--storage-providers--storageProvider_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
onclick="cancelTryOut('GETapi-projects--project_id--storage-providers--storageProvider_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-green">GET</small>
|
|
<b><code>api/projects/{project_id}/storage-providers/{storageProvider_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>storageProvider_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="storageProvider_id" data-endpoint="GETapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the storageProvider. Example: <code>3</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="storage-providers-PUTapi-projects--project_id--storage-providers--storageProvider_id-">update</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-PUTapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">curl --request PUT \
|
|
"https://your-vito-url/api/projects/1/storage-providers/3" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"exercitationem\",
|
|
\"global\": true
|
|
}"
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$client = new \GuzzleHttp\Client();
|
|
$url = 'https://your-vito-url/api/projects/1/storage-providers/3';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'exercitationem',
|
|
'global' => true,
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/storage-providers/3"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "exercitationem",
|
|
"global": true
|
|
};
|
|
|
|
fetch(url, {
|
|
method: "PUT",
|
|
headers,
|
|
body: JSON.stringify(body),
|
|
}).then(response => response.json());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-PUTapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<blockquote>
|
|
<p>Example response (200):</p>
|
|
</blockquote>
|
|
<pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"id": 5,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "dolorum",
|
|
"provider": "s3",
|
|
"created_at": "2025-03-31T15:27:17.000000Z",
|
|
"updated_at": "2025-03-31T15:27:17.000000Z"
|
|
}</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-PUTapi-projects--project_id--storage-providers--storageProvider_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-PUTapi-projects--project_id--storage-providers--storageProvider_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-PUTapi-projects--project_id--storage-providers--storageProvider_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-PUTapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-PUTapi-projects--project_id--storage-providers--storageProvider_id-" data-method="PUT"
|
|
data-path="api/projects/{project_id}/storage-providers/{storageProvider_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('PUTapi-projects--project_id--storage-providers--storageProvider_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
onclick="tryItOut('PUTapi-projects--project_id--storage-providers--storageProvider_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
onclick="cancelTryOut('PUTapi-projects--project_id--storage-providers--storageProvider_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-darkblue">PUT</small>
|
|
<b><code>api/projects/{project_id}/storage-providers/{storageProvider_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>storageProvider_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="storageProvider_id" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the storageProvider. Example: <code>3</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>Body Parameters</b></h4>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>name</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="name" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="exercitationem"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>exercitationem</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>global</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="global" data-endpoint="PUTapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value=""
|
|
data-component="body">
|
|
<br>
|
|
<p>Accessible in all projects Example: <code>true</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>1</code></li> <li><code></code></li></ul>
|
|
</div>
|
|
</form>
|
|
|
|
<h2 id="storage-providers-DELETEapi-projects--project_id--storage-providers--storageProvider_id-">delete</h2>
|
|
|
|
<p>
|
|
<small class="badge badge-darkred">requires authentication</small>
|
|
</p>
|
|
|
|
|
|
|
|
<span id="example-requests-DELETEapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<blockquote>Example request:</blockquote>
|
|
|
|
|
|
<div class="bash-example">
|
|
<pre><code class="language-bash">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"</code></pre></div>
|
|
|
|
|
|
<div class="php-example">
|
|
<pre><code class="language-php">$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));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">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());</code></pre></div>
|
|
|
|
</span>
|
|
|
|
<span id="example-responses-DELETEapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
<blockquote>
|
|
<p>Example response (204):</p>
|
|
</blockquote>
|
|
<pre>
|
|
<code>Empty response</code>
|
|
</pre>
|
|
</span>
|
|
<span id="execution-results-DELETEapi-projects--project_id--storage-providers--storageProvider_id-" hidden>
|
|
<blockquote>Received response<span
|
|
id="execution-response-status-DELETEapi-projects--project_id--storage-providers--storageProvider_id-"></span>:
|
|
</blockquote>
|
|
<pre class="json"><code id="execution-response-content-DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
data-empty-response-text="<Empty response>" style="max-height: 400px;"></code></pre>
|
|
</span>
|
|
<span id="execution-error-DELETEapi-projects--project_id--storage-providers--storageProvider_id-" hidden>
|
|
<blockquote>Request failed with error:</blockquote>
|
|
<pre><code id="execution-error-message-DELETEapi-projects--project_id--storage-providers--storageProvider_id-">
|
|
|
|
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.</code></pre>
|
|
</span>
|
|
<form id="form-DELETEapi-projects--project_id--storage-providers--storageProvider_id-" data-method="DELETE"
|
|
data-path="api/projects/{project_id}/storage-providers/{storageProvider_id}"
|
|
data-authed="1"
|
|
data-hasfiles="0"
|
|
data-isarraybody="0"
|
|
autocomplete="off"
|
|
onsubmit="event.preventDefault(); executeTryOut('DELETEapi-projects--project_id--storage-providers--storageProvider_id-', this);">
|
|
<h3>
|
|
Request
|
|
<button type="button"
|
|
style="background-color: #8fbcd4; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-tryout-DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
onclick="tryItOut('DELETEapi-projects--project_id--storage-providers--storageProvider_id-');">Try it out ⚡
|
|
</button>
|
|
<button type="button"
|
|
style="background-color: #c97a7e; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-canceltryout-DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
onclick="cancelTryOut('DELETEapi-projects--project_id--storage-providers--storageProvider_id-');" hidden>Cancel 🛑
|
|
</button>
|
|
<button type="submit"
|
|
style="background-color: #6ac174; padding: 5px 10px; border-radius: 5px; border-width: thin;"
|
|
id="btn-executetryout-DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
data-initial-text="Send Request 💥"
|
|
data-loading-text="⏱ Sending..."
|
|
hidden>Send Request 💥
|
|
</button>
|
|
</h3>
|
|
<p>
|
|
<small class="badge badge-red">DELETE</small>
|
|
<b><code>api/projects/{project_id}/storage-providers/{storageProvider_id}</code></b>
|
|
</p>
|
|
<h4 class="fancy-heading-panel"><b>Headers</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Authorization</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Authorization" class="auth-value" data-endpoint="DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="Bearer YOUR-API-KEY"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>Bearer YOUR-API-KEY</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Content-Type</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Content-Type" data-endpoint="DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>Accept</code></b>
|
|
|
|
|
|
<input type="text" style="display: none"
|
|
name="Accept" data-endpoint="DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="application/json"
|
|
data-component="header">
|
|
<br>
|
|
<p>Example: <code>application/json</code></p>
|
|
</div>
|
|
<h4 class="fancy-heading-panel"><b>URL Parameters</b></h4>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>project_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="project_id" data-endpoint="DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the project. Example: <code>1</code></p>
|
|
</div>
|
|
<div style="padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>storageProvider_id</code></b>
|
|
<small>integer</small>
|
|
|
|
<input type="number" style="display: none"
|
|
step="any" name="storageProvider_id" data-endpoint="DELETEapi-projects--project_id--storage-providers--storageProvider_id-"
|
|
value="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the storageProvider. Example: <code>3</code></p>
|
|
</div>
|
|
</form>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
<div class="dark-box">
|
|
<div class="lang-selector">
|
|
<button type="button" class="lang-button" data-language-name="bash">bash</button>
|
|
<button type="button" class="lang-button" data-language-name="php">php</button>
|
|
<button type="button" class="lang-button" data-language-name="javascript">javascript</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|