mirror of
https://github.com/vitodeploy/vito.git
synced 2025-04-21 19:01:37 +00:00
12507 lines
548 KiB
HTML
12507 lines
548 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.38.0.js"></script>
|
|
|
|
<script src="./js/theme-default-4.38.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-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-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>
|
|
</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: November 1, 2024</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/3/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/3/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/3/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/cron-jobs" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"command\": \"qui\",
|
|
\"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/3/cron-jobs';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'command' => 'qui',
|
|
'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/3/cron-jobs"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"command": "qui",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. 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>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="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>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/3/cron-jobs/5" \
|
|
--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/3/cron-jobs/5';
|
|
$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/3/cron-jobs/5"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="5"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the cronJob. Example: <code>5</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/3/cron-jobs/5" \
|
|
--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/3/cron-jobs/5';
|
|
$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/3/cron-jobs/5"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="5"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the cronJob. Example: <code>5</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/3/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/3/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/3/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": "nyasia68",
|
|
"databases": [],
|
|
"host": "%",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"username": "madyson20",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/database-users" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"username\": \"dignissimos\",
|
|
\"password\": \"OK+XEG2)\",
|
|
\"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/3/database-users';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'username' => 'dignissimos',
|
|
'password' => 'OK+XEG2)',
|
|
'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/3/database-users"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"username": "dignissimos",
|
|
"password": "OK+XEG2)",
|
|
"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": "amya.nitzsche",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. 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>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="dignissimos"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>dignissimos</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="OK+XEG2)"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>OK+XEG2)</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/3/database-users/4" \
|
|
--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/3/database-users/4';
|
|
$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/3/database-users/4"
|
|
);
|
|
|
|
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": "bergstrom.ericka",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="4"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the databaseUser. Example: <code>4</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/3/database-users/4/link" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"databases\": \"accusantium\"
|
|
}"
|
|
</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/3/database-users/4/link';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'databases' => 'accusantium',
|
|
],
|
|
]
|
|
);
|
|
$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/3/database-users/4/link"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"databases": "accusantium"
|
|
};
|
|
|
|
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": "fmurray",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="4"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the databaseUser. Example: <code>4</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="accusantium"
|
|
data-component="body">
|
|
<br>
|
|
<p>Array of database names to link to the user. Example: <code>accusantium</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/3/database-users/4" \
|
|
--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/3/database-users/4';
|
|
$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/3/database-users/4"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="4"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the databaseUser. Example: <code>4</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/3/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/3/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/3/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": "clockman",
|
|
"status": "ready",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"name": "wvonrueden",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/databases" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"nesciunt\"
|
|
}"
|
|
</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/3/databases';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'nesciunt',
|
|
],
|
|
]
|
|
);
|
|
$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/3/databases"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "nesciunt"
|
|
};
|
|
|
|
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": "johanna76",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. 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="POSTapi-projects--project_id--servers--server_id--databases"
|
|
value="nesciunt"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>nesciunt</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/3/databases/6" \
|
|
--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/3/databases/6';
|
|
$response = $client->get(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
]
|
|
);
|
|
$body = $response->getBody();
|
|
print_r(json_decode((string) $body));</code></pre></div>
|
|
|
|
|
|
<div class="javascript-example">
|
|
<pre><code class="language-javascript">const url = new URL(
|
|
"https://your-vito-url/api/projects/1/servers/3/databases/6"
|
|
);
|
|
|
|
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": "chloe.huel",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="6"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the database. Example: <code>6</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/3/databases/6" \
|
|
--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/3/databases/6';
|
|
$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/3/databases/6"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="6"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the database. Example: <code>6</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/3/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/3/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/3/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,
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 18074,
|
|
"source": "189.27.156.82",
|
|
"mask": 24,
|
|
"note": "test",
|
|
"status": null,
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 41088,
|
|
"source": "86.177.121.87",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/firewall-rules" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"type\": \"allow\",
|
|
\"protocol\": \"udp\",
|
|
\"port\": \"voluptates\",
|
|
\"source\": \"saepe\",
|
|
\"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/3/firewall-rules';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'type' => 'allow',
|
|
'protocol' => 'udp',
|
|
'port' => 'voluptates',
|
|
'source' => 'saepe',
|
|
'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/3/firewall-rules"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"type": "allow",
|
|
"protocol": "udp",
|
|
"port": "voluptates",
|
|
"source": "saepe",
|
|
"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,
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 61992,
|
|
"source": "47.222.76.48",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. 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>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="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="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="voluptates"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>voluptates</code></p>
|
|
</div>
|
|
<div style=" padding-left: 28px; clear: unset;">
|
|
<b style="line-height: 2;"><code>source</code></b>
|
|
<small>string</small>
|
|
|
|
<input type="text" style="display: none"
|
|
name="source" data-endpoint="POSTapi-projects--project_id--servers--server_id--firewall-rules"
|
|
value="saepe"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>saepe</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-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/3/firewall-rules/7" \
|
|
--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/3/firewall-rules/7';
|
|
$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/3/firewall-rules/7"
|
|
);
|
|
|
|
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,
|
|
"server_id": null,
|
|
"type": "allow",
|
|
"protocol": "tcp",
|
|
"port": 43107,
|
|
"source": "135.73.216.16",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="7"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the firewallRule. Example: <code>7</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/3/firewall-rules/7" \
|
|
--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/3/firewall-rules/7';
|
|
$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/3/firewall-rules/7"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="7"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the firewallRule. Example: <code>7</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: 59
|
|
access-control-allow-origin: *
|
|
</code></pre></details> <pre>
|
|
|
|
<code class="language-json" style="max-height: 300px;">{
|
|
"success": true,
|
|
"version": "2.0.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": 29,
|
|
"name": "Zachary Lueilwitz",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.000000Z"
|
|
},
|
|
{
|
|
"id": 30,
|
|
"name": "Mrs. Kiarra Heller IV",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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\": \"quos\"
|
|
}"
|
|
</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' => 'quos',
|
|
],
|
|
]
|
|
);
|
|
$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": "quos"
|
|
};
|
|
|
|
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": 29,
|
|
"name": "Hershel Spinka",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="quos"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the project. Example: <code>quos</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": 29,
|
|
"name": "Emery Kiehn",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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\": \"ut\"
|
|
}"
|
|
</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' => 'ut',
|
|
],
|
|
]
|
|
);
|
|
$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": "ut"
|
|
};
|
|
|
|
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": 29,
|
|
"name": "Mable Prohaska",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="ut"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the project. Example: <code>ut</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="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": 2,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "dolor",
|
|
"provider": "digitalocean",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.000000Z"
|
|
},
|
|
{
|
|
"id": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "enim",
|
|
"provider": "digitalocean",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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\": \"autem\",
|
|
\"name\": \"enim\",
|
|
\"token\": \"culpa\",
|
|
\"key\": \"sit\",
|
|
\"secret\": \"voluptates\"
|
|
}"
|
|
</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' => 'autem',
|
|
'name' => 'enim',
|
|
'token' => 'culpa',
|
|
'key' => 'sit',
|
|
'secret' => 'voluptates',
|
|
],
|
|
]
|
|
);
|
|
$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": "autem",
|
|
"name": "enim",
|
|
"token": "culpa",
|
|
"key": "sit",
|
|
"secret": "voluptates"
|
|
};
|
|
|
|
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": 2,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "eligendi",
|
|
"provider": "aws",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="autem"
|
|
data-component="body">
|
|
<br>
|
|
<p>The provider (aws, linode, hetzner, digitalocean, vultr, ...) Example: <code>autem</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="enim"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the server provider. Example: <code>enim</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="culpa"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>culpa</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="sit"
|
|
data-component="body">
|
|
<br>
|
|
<p>The key if provider requires key Example: <code>sit</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="voluptates"
|
|
data-component="body">
|
|
<br>
|
|
<p>The secret if provider requires key Example: <code>voluptates</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": 2,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "architecto",
|
|
"provider": "digitalocean",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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\": \"minus\",
|
|
\"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' => 'minus',
|
|
'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": "minus",
|
|
"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": 2,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "reiciendis",
|
|
"provider": "hetzner",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="minus"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the server provider. Example: <code>minus</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": "Dorthy Toy",
|
|
"ssh_user": "vito",
|
|
"ip": "172.132.95.155",
|
|
"local_ip": "118.57.197.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": "Carrie Sporer",
|
|
"ssh_user": "vito",
|
|
"ip": "184.242.162.173",
|
|
"local_ip": "135.244.50.22",
|
|
"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\": \"et\",
|
|
\"server_provider\": \"digitalocean\",
|
|
\"region\": \"inventore\",
|
|
\"plan\": \"atque\",
|
|
\"ip\": \"quam\",
|
|
\"port\": \"nemo\",
|
|
\"name\": \"perspiciatis\",
|
|
\"os\": \"similique\",
|
|
\"type\": \"regular\",
|
|
\"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' => 'et',
|
|
'server_provider' => 'digitalocean',
|
|
'region' => 'inventore',
|
|
'plan' => 'atque',
|
|
'ip' => 'quam',
|
|
'port' => 'nemo',
|
|
'name' => 'perspiciatis',
|
|
'os' => 'similique',
|
|
'type' => 'regular',
|
|
'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": "et",
|
|
"server_provider": "digitalocean",
|
|
"region": "inventore",
|
|
"plan": "atque",
|
|
"ip": "quam",
|
|
"port": "nemo",
|
|
"name": "perspiciatis",
|
|
"os": "similique",
|
|
"type": "regular",
|
|
"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": "Flo Beer PhD",
|
|
"ssh_user": "vito",
|
|
"ip": "168.238.14.230",
|
|
"local_ip": "40.232.73.41",
|
|
"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="et"
|
|
data-component="body">
|
|
<br>
|
|
<p>The server provider type Example: <code>et</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="digitalocean"
|
|
data-component="body">
|
|
<br>
|
|
<p>If the provider is not custom, the ID of the server provider profile Example: <code>digitalocean</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="inventore"
|
|
data-component="body">
|
|
<br>
|
|
<p>Provider region if the provider is not custom Example: <code>inventore</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="atque"
|
|
data-component="body">
|
|
<br>
|
|
<p>Provider plan if the provider is not custom Example: <code>atque</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="quam"
|
|
data-component="body">
|
|
<br>
|
|
<p>SSH IP address if the provider is custom Example: <code>quam</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="nemo"
|
|
data-component="body">
|
|
<br>
|
|
<p>SSH Port if the provider is custom Example: <code>nemo</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="perspiciatis"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the server. Example: <code>perspiciatis</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="similique"
|
|
data-component="body">
|
|
<br>
|
|
<p>The os of the server Example: <code>similique</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"
|
|
value="regular"
|
|
data-component="body">
|
|
<br>
|
|
<p>Server type Example: <code>regular</code></p>
|
|
Must be one of:
|
|
<ul style="list-style-type: square;"><li><code>regular</code></li> <li><code>database</code></li></ul>
|
|
</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/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/servers/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/servers/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--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": "Stephany Ankunding",
|
|
"ssh_user": "vito",
|
|
"ip": "145.28.94.46",
|
|
"local_ip": "69.133.44.100",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/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/3/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/3/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/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/3/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/3/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/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/servers/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/servers/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--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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/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/3/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/3/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/services/27" \
|
|
--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/3/services/27';
|
|
$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/3/services/27"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/services/27/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/3/services/27/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/3/services/27/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/services/27/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/3/services/27/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/3/services/27/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/services/27/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/3/services/27/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/3/services/27/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/services/27/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/3/services/27/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/3/services/27/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/services/27/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/3/services/27/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/3/services/27/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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/services/27" \
|
|
--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/3/services/27';
|
|
$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/3/services/27"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="27"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the service. Example: <code>27</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/3/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/3/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/3/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,
|
|
"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,
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/sites" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"type\": \"wordpress\",
|
|
\"domain\": \"quo\",
|
|
\"aliases\": [
|
|
\"dolorum\"
|
|
],
|
|
\"php_version\": \"7.4\",
|
|
\"web_directory\": \"public\",
|
|
\"source_control\": \"explicabo\",
|
|
\"repository\": \"organization\\/repository\",
|
|
\"branch\": \"main\",
|
|
\"composer\": true,
|
|
\"version\": \"5.2.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/3/sites';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'type' => 'wordpress',
|
|
'domain' => 'quo',
|
|
'aliases' => [
|
|
'dolorum',
|
|
],
|
|
'php_version' => '7.4',
|
|
'web_directory' => 'public',
|
|
'source_control' => 'explicabo',
|
|
'repository' => 'organization/repository',
|
|
'branch' => 'main',
|
|
'composer' => true,
|
|
'version' => '5.2.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/3/sites"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"type": "wordpress",
|
|
"domain": "quo",
|
|
"aliases": [
|
|
"dolorum"
|
|
],
|
|
"php_version": "7.4",
|
|
"web_directory": "public",
|
|
"source_control": "explicabo",
|
|
"repository": "organization\/repository",
|
|
"branch": "main",
|
|
"composer": true,
|
|
"version": "5.2.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--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,
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. 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>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="wordpress"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>wordpress</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></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="quo"
|
|
data-component="body">
|
|
<br>
|
|
<p>Example: <code>quo</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="explicabo"
|
|
data-component="body">
|
|
<br>
|
|
<p>Source control ID, Required for Sites which support source control Example: <code>explicabo</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>
|
|
</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/3/sites/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/3/sites/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/3/sites/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--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,
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="8"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>8</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/3/sites/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/3/sites/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/3/sites/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--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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="8"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the site. Example: <code>8</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": "Jaiden Kling",
|
|
"provider": "github",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.000000Z"
|
|
},
|
|
{
|
|
"id": 6,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "Ms. Brianne Bosco",
|
|
"provider": "github",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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\": \"bitbucket\",
|
|
\"name\": \"eos\",
|
|
\"token\": \"et\",
|
|
\"url\": \"https:\\/\\/lueilwitz.com\\/nostrum-et-porro-atque-sint.html\",
|
|
\"username\": \"consectetur\",
|
|
\"password\": \"PL.P?{06\\\\ECi0\"
|
|
}"
|
|
</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' => 'bitbucket',
|
|
'name' => 'eos',
|
|
'token' => 'et',
|
|
'url' => 'https://lueilwitz.com/nostrum-et-porro-atque-sint.html',
|
|
'username' => 'consectetur',
|
|
'password' => 'PL.P?{06\\ECi0',
|
|
],
|
|
]
|
|
);
|
|
$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": "bitbucket",
|
|
"name": "eos",
|
|
"token": "et",
|
|
"url": "https:\/\/lueilwitz.com\/nostrum-et-porro-atque-sint.html",
|
|
"username": "consectetur",
|
|
"password": "PL.P?{06\\ECi0"
|
|
};
|
|
|
|
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": "Toby Parker",
|
|
"provider": "github",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="bitbucket"
|
|
data-component="body">
|
|
<br>
|
|
<p>The provider Example: <code>bitbucket</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="eos"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>eos</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="et"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>et</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://lueilwitz.com/nostrum-et-porro-atque-sint.html"
|
|
data-component="body">
|
|
<br>
|
|
<p>The URL if the provider is Gitlab and it is self-hosted Example: <code>https://lueilwitz.com/nostrum-et-porro-atque-sint.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="consectetur"
|
|
data-component="body">
|
|
<br>
|
|
<p>The username if the provider is Bitbucket Example: <code>consectetur</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="PL.P?{06\ECi0"
|
|
data-component="body">
|
|
<br>
|
|
<p>The password if the provider is Bitbucket Example: <code>PL.P?{06\ECi0</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/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/source-controls/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/source-controls/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--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": "Prof. Bartholome Graham IV",
|
|
"provider": "github",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sourceControl. Example: <code>3</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/3" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"quaerat\",
|
|
\"token\": \"consectetur\",
|
|
\"url\": \"http:\\/\\/www.hudson.biz\\/rerum-voluptatem-debitis-accusamus\",
|
|
\"username\": \"voluptatem\",
|
|
\"password\": \"\\\\p\\/el>)3#~E?kI\",
|
|
\"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/3';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'quaerat',
|
|
'token' => 'consectetur',
|
|
'url' => 'http://www.hudson.biz/rerum-voluptatem-debitis-accusamus',
|
|
'username' => 'voluptatem',
|
|
'password' => '\\p/el>)3#~E?kI',
|
|
'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/3"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "quaerat",
|
|
"token": "consectetur",
|
|
"url": "http:\/\/www.hudson.biz\/rerum-voluptatem-debitis-accusamus",
|
|
"username": "voluptatem",
|
|
"password": "\\p\/el>)3#~E?kI",
|
|
"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": "Cicero Smitham",
|
|
"provider": "github",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sourceControl. 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--source-controls--sourceControl_id-"
|
|
value="quaerat"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>quaerat</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="consectetur"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>consectetur</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://www.hudson.biz/rerum-voluptatem-debitis-accusamus"
|
|
data-component="body">
|
|
<br>
|
|
<p>The URL if the provider is Gitlab and it is self-hosted Example: <code>http://www.hudson.biz/rerum-voluptatem-debitis-accusamus</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="voluptatem"
|
|
data-component="body">
|
|
<br>
|
|
<p>The username if the provider is Bitbucket Example: <code>voluptatem</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="\p/el>)3#~E?kI"
|
|
data-component="body">
|
|
<br>
|
|
<p>The password if the provider is Bitbucket Example: <code>\p/el>)3#~E?kI</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/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/source-controls/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/source-controls/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--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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sourceControl. Example: <code>3</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/3/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/3/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/3/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. Reanna Braun",
|
|
"created_at": null,
|
|
"updated_at": null
|
|
},
|
|
{
|
|
"id": null,
|
|
"user": null,
|
|
"name": "Norene Fritsch",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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/3/ssh-keys" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"key_id\": \"vero\",
|
|
\"name\": \"voluptates\",
|
|
\"public_key\": \"dolor\"
|
|
}"
|
|
</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/3/ssh-keys';
|
|
$response = $client->post(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'key_id' => 'vero',
|
|
'name' => 'voluptates',
|
|
'public_key' => 'dolor',
|
|
],
|
|
]
|
|
);
|
|
$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/3/ssh-keys"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"key_id": "vero",
|
|
"name": "voluptates",
|
|
"public_key": "dolor"
|
|
};
|
|
|
|
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": "Sophia D'Amore",
|
|
"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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. 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>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="vero"
|
|
data-component="body">
|
|
<br>
|
|
<p>The ID of the key. Example: <code>vero</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="voluptates"
|
|
data-component="body">
|
|
<br>
|
|
<p>Key name, required if key_id is not provided. Example: <code>voluptates</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="dolor"
|
|
data-component="body">
|
|
<br>
|
|
<p>Public Key, required if key_id is not provided. Example: <code>dolor</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/3/ssh-keys/4" \
|
|
--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/3/ssh-keys/4';
|
|
$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/3/ssh-keys/4"
|
|
);
|
|
|
|
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="3"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the server. Example: <code>3</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="4"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the sshKey. Example: <code>4</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": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "et",
|
|
"provider": "local",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.000000Z"
|
|
},
|
|
{
|
|
"id": 4,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "sed",
|
|
"provider": "local",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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\": \"quod\",
|
|
\"name\": \"commodi\",
|
|
\"token\": \"ipsum\",
|
|
\"key\": \"ratione\",
|
|
\"secret\": \"iste\"
|
|
}"
|
|
</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' => 'quod',
|
|
'name' => 'commodi',
|
|
'token' => 'ipsum',
|
|
'key' => 'ratione',
|
|
'secret' => 'iste',
|
|
],
|
|
]
|
|
);
|
|
$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": "quod",
|
|
"name": "commodi",
|
|
"token": "ipsum",
|
|
"key": "ratione",
|
|
"secret": "iste"
|
|
};
|
|
|
|
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": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "est",
|
|
"provider": "dropbox",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="quod"
|
|
data-component="body">
|
|
<br>
|
|
<p>The provider (aws, linode, hetzner, digitalocean, vultr, ...) Example: <code>quod</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="commodi"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>commodi</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="ipsum"
|
|
data-component="body">
|
|
<br>
|
|
<p>The token if provider requires api token Example: <code>ipsum</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="ratione"
|
|
data-component="body">
|
|
<br>
|
|
<p>The key if provider requires key Example: <code>ratione</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="iste"
|
|
data-component="body">
|
|
<br>
|
|
<p>The secret if provider requires key Example: <code>iste</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/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/storage-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/storage-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--storage-providers--storageProvider_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": "officia",
|
|
"provider": "ftp",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the storageProvider. Example: <code>1</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/1" \
|
|
--header "Authorization: Bearer YOUR-API-KEY" \
|
|
--header "Content-Type: application/json" \
|
|
--header "Accept: application/json" \
|
|
--data "{
|
|
\"name\": \"iusto\",
|
|
\"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/1';
|
|
$response = $client->put(
|
|
$url,
|
|
[
|
|
'headers' => [
|
|
'Authorization' => 'Bearer YOUR-API-KEY',
|
|
'Content-Type' => 'application/json',
|
|
'Accept' => 'application/json',
|
|
],
|
|
'json' => [
|
|
'name' => 'iusto',
|
|
'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/1"
|
|
);
|
|
|
|
const headers = {
|
|
"Authorization": "Bearer YOUR-API-KEY",
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
};
|
|
|
|
let body = {
|
|
"name": "iusto",
|
|
"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": 3,
|
|
"project_id": null,
|
|
"global": true,
|
|
"name": "rerum",
|
|
"provider": "ftp",
|
|
"created_at": "2024-11-01T15:40:48.000000Z",
|
|
"updated_at": "2024-11-01T15:40:48.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="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the storageProvider. 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--storage-providers--storageProvider_id-"
|
|
value="iusto"
|
|
data-component="body">
|
|
<br>
|
|
<p>The name of the storage provider. Example: <code>iusto</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/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/storage-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/storage-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--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="1"
|
|
data-component="url">
|
|
<br>
|
|
<p>The ID of the storageProvider. Example: <code>1</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>
|